Уценка Github, которая уважает переводы строк

Question

У меня есть текстовый файл со списком, который выглядит следующим образом

# Actors
Robert Mitchum
John Voight

# Musicians
Geddy Lee
Angus Young

Я бы хотел добавить этот текст на страницу Github Wiki и сделать так, чтобы он отображался так: (одна строка текста для каждой строки текста в моем текстовом файле)

Но по умолчанию, уценка github будет отображать это так:

Есть ли в Github какие-либо предопределенные режимы редактирования, которые могли бы достичь этого? Вот список доступных режимов редактирования

Мне нравится уценка в целом, мне просто нужен формат, который учитывает разрывы строк. Предпочел бы продолжить использовать что-то с теми же символами, что и уценка. (Но мне в основном нужны только символы # для заголовков) Однако я мог бы переключиться на совершенно другой стиль, если бы мне пришлось. (поиск и замена моих хештегов на другие символы будет легко) Я просто хочу формат, который учитывает переводы строки и имеет базовое форматирование для заголовков.

Answer 1

Спецификация GitHub Flavored Markdown определяет два типа разрывов строк:

Жесткие разрывы строк

Разрыв строки (не в диапазоне кода или теге HTML), которому предшествуют два или больше пробелов и не встречается в конце блока, анализируется как жесткий разрыв строки (отображается в HTML как тег <br />)

Мягкие разрывы строк

Обычный разрыв строки (не в интервале кода или HTML-теге), который не является предшествует два или более пробелов или обратный слеш анализируется как softbreak. (Мягкий разрыв может быть представлен в HTML либо в виде строки окончание или как пробел. Результат будет таким же в браузерах. В в примерах здесь будет использоваться конец строки .)

Похоже, вы ожидаете, что разрывы мягких линий будут рассматриваться как разрывы жестких линий. Однако важно помнить, что Markdown является подмножеством HTML, и браузеры сворачивают пробельные символы в HTML, включая вкладки, пробелы, символы новой строки и другие, в один пробел. Поэтому, хотя перевод строки сохраняется в выводе HTML, ваш браузер не будет отображать его.

Учитывая вышесказанное, вы можете использовать жесткие разрывы строк, чтобы принудительно сохранить разрывы строк (в HTML вставлен тег <br />). Вот так (точка используется вместо пробела в демонстрационных целях):

# Actors
Robert Mitchum··
John Voight

# Musicians
Geddy Lee··
Angus Young

И это дает вам следующий HTML:

<h1>Actors</h1>
<p>Robert Mitchum <br />
John Voight</p>
<h1>Musicians</h1>
<p>Geddy Lee <br />
Angus Young</p>

Обратите внимание на теги <br />, вставленные в соответствующем месте, что вызывает разрыв строки. Выше приведено как:

Актеры

Роберт Митчум
Джон Войт

Музыканты

Гедди Ли
Ангус Янг

Но вы, вероятно, хотите отдельные абзацы

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

# Actors

Robert Mitchum

John Voight

# Musicians

Geddy Lee

Angus Young

Что приводит к этому HTML:

<h1>Actors</h1>
<p>Robert Mitchum</p>
<p>John Voight</p>
<h1>Musicians</h1>
<p>Geddy Lee</p>
<p>Angus Young</p>

И отображается как:

Актеры

Роберт Митчум

Джон Войт

Музыканты

Гедди Ли

Ангус Янг

Answer 2

Добавить 2 пробела в конце строки:
Вот так:

# Actors
Robert Mitchum  
John Voight  

Актеры

Роберт Митчум
Джон Войт

Музыканты

Гедди Ли
Ангус Янг

Answer 3

Это что-то связанное с грамматикой Markdown. Если вы используете StackOverflow, вы можете заметить в режиме предварительного просмотра, что одиночная новая строка между текстами может просто создать пробел, а double новая строка может сгенерировать настоящую новую строку. Вы можете обратиться к GitHub Wiki: adam-p / markdown-here о переводе строки.

Для оригинального ответа добавьте новую строку, чтобы решить эту проблему.

# Actors
Robert Mitchum

John Voight

# Musicians
Geddy Lee

Angus Young

Это дает текст ниже:

Актеры

Роберт Митчум

Джон Войт

Музыканты

Гедди Ли

Ангус Янг