Разрывать длинные строки в коде разметки

Я использую уценку с оригинальным ароматом, как описано здесь.

Мне интересно, возможно ли сломать длинную строку в коде разметки, в результате чего синтаксический эффект не будет. (В других языках, например, сценарии оболочки и C, \ будут использоваться для продолжения следующей строки.) Я спрашиваю об этом, потому что символы новой строки иногда нарушают синтаксис, как в

[StackOverflow]
(http://qaru.site/)

Это будет выглядеть как "[StackOverflow] (/qaru.site/...)" в фактическом html, а не в гиперссылке, поскольку newline интерпретируется как пробел и пробелы не допускается между ] и ( в синтаксисе [text](url) для ссылок.

Ответ 1

Если вы хотите иметь разрывы строк в коде, то, как сообщают комментарии, используйте разрывы строк внутри текстовой части или внутри части url: вы действительно можете сделать это

[StackOverflow](
http://stackoverflow.com)

И хотя результат будет иметь дополнительные пробелы внутри href, он все равно будет работать, поэтому не стоит беспокоиться. Это также работает для распространения длинных ссылок на несколько строк.

[StackOverflow interesting discussion](
    http://stackoverflow.com/this/discussion/has/a/very/
very/very/very/long/long/long/title/title/title

Обязательно не допускайте каких-либо ведущих пробелов в строках, начинающихся с URL-адреса (здесь последняя строка). (только первый разрыв строки работает с уценкой GitHub, поскольку GitHub рассматривает разрывы строк как пробелы).

Однако если цель состоит в том, чтобы сделать ссылки более читабельными, я бы рекомендовал использовать ссылки ссылок, чтобы вы могли разместить фактические hrefs в любом месте документа и иметь короткие и читаемые заголовки ссылок в тексте:

[StackOverflow][]

[StackOverflow]: http://stackoverflow.com

или

[StackOverflow][1]

[1]: http://stackoverflow.com

Обратите внимание, что вы можете размещать ссылку в любом месте: часто ее легко читать и легко поддерживать, когда все ссылки находятся в нижней части readme.

Кроме того, этот metgod позволит вам добавить атрибут title к ссылкам, если они вам понадобятся:

[StackOverflow][]

[StackOverflow]: http://stackoverflow.com (Here is this link title!)