Як зробити перенос рядка в Markdown:два пробіли, зворотна скісна риска або тег br.

Ви натискаєте Enter у Markdown-файлі, а два рядки відображаються як один. Так задумано. Ось чому це відбувається і три способи примусово почати новий рядок.

macOS 14 або новіша. Читати можна безкоштовно; редагування й рев'ю оплачуються один раз.

Коротко

Один перенос рядка в Markdown вважається пробілом, тому рядки зливаються. Щоб розірвати рядок, закінчіть його двома пробілами, зворотною скісною рискою або HTML-тегом <br>. Щоб почати новий абзац, залиште порожній рядок.

First line\
Second line, after a backslash

Next paragraph, after a blank line

·

Чому Markdown ігнорує новий рядок

Markdown склеює рядки абзацу. Якщо ви напишете

Roses are red
Violets are blue

читач побачить один абзац: Roses are red Violets are blue. Перенос рядка у вихідному тексті — це м'який перенос: місце, де ви розбили текст, а не де читач має побачити розрив. Він дозволяє переносити довгі рядки в редакторі, не змінюючи вигляду сторінки.

Порожній рядок — інша річ. Він закінчує абзац і починає новий, з проміжком між ними. Найчастіше потрібен саме такий розрив.

Три способи примусово перенести рядок

Примусовий перенос, він же жорсткий, лишає текст в тому самому абзаці й починає наступний рядок.

  1. Два пробіли наприкінці рядка

    Наберіть щонайменше два пробіли перед Enter. Працює всюди, але пробілів не видно, а деякі редактори й налаштування Git їх прибирають.

  2. Зворотна скісна риска наприкінці рядка

    Поставте \ останнім символом, без пробілу після нього. Вона видима й не зникає під час обрізання. Це частина CommonMark і GitHub Flavored Markdown, хоча деякі старі застосунки її не знають.

  3. HTML-тег br

    Закінчіть рядок на <br> (або <br/>). Працює майже в кожному застосунку, що приймає вбудований HTML. Це також єдиний спосіб розірвати рядок усередині комірки таблиці.

Two spaces after this line  
comes out on a new line.

A backslash ends this one\
and breaks it too.

A tag also works.<br>
Third line.

Усі три дають однаковий результат:

Два пробіли після цього рядка
продовжуються на новому рядку.

Який спосіб обрати

  • Новий абзац (порожній рядок) для будь-якої окремої думки. Найпереносніший варіант.
  • Зворотна скісна риска, коли потрібен розрив посеред абзацу, наприклад в адресі чи вірші, і застосунок дотримується CommonMark.
  • Тег br у комірці таблиці або коли ви не певні, що застосунок підтримує два інші способи.
  • Два пробіли лише коли ви певні, що їх ніхто не прибере.

Усередині рядкового коду розриви не працюють, а розрив у самому кінці абзацу нічого не робить. Якщо потрібен порожній проміжок, використайте порожній рядок або заголовок, а не купу тегів <br>.

Приклади: адреса, вірш, пункт списку

Жорсткий перенос підходить для тексту, де важливий сам рядок, наприклад для поштової адреси:

Jane Smith221B Baker StreetLondon

Іван Петренко
вул. Бейкер-стріт, 221B
Лондон

Усередині пункту списку закінчіть рядок розривом і зсуньте наступний так, щоб він збігався з текстом пункту:

- Pack the bags  and lock the door
- Leave at eight

Якщо розрив потрібен у кожному рядку довгого тексту, ймовірно, це список або блок коду, а для обох у Markdown є синтаксис.

Коли перенос рядка все одно не працює

  • Один пробіл наприкінці. Потрібно два або більше.
  • Пробіл після зворотної скісної риски. Вона має бути останнім символом у рядку.
  • Редактор прибирає пробіли в кінці рядків під час збереження. Перейдіть на зворотну скісну риску або тег br.
  • Той самий текст виглядає по-різному в двох місцях. Деякі застосунки, наприклад поля issues і коментарів на GitHub, зберігають одиничні переноси рядків як розриви, а Markdown-файл на GitHub ні. Примусовий розрив виглядає однаково скрізь.
  • Текст усередині пункту списку чи цитати. Залиште розрив наприкінці рядка, а наступний рядок зсуньте за пунктом.

Найшвидше перевірити, відкривши файл у програмі для читання. DotMD дотримується цих правил: одиничний перенос рядка склеює рядки, а два пробіли, зворотна скісна риска чи <br> розривають рядок. Читання безкоштовне, а в DotMD Editor живий попередній перегляд показує результат у міру набору.

Питання про переноси рядків у Markdown

Як додати новий рядок у Markdown?

Щоб розірвати рядок усередині абзацу, закінчіть його двома пробілами, зворотною скісною рискою чи тегом <br>. Щоб почати новий абзац, залиште порожній рядок.

Чому в Markdown ігнорується новий рядок?

Markdown вважає одиничний перенос рядка пробілом, тому рядки склеюються в один абзац. Щоб отримати видимий розрив, використайте порожній рядок, два пробіли наприкінці, зворотну скісну риску або <br>.

Чи завжди два пробіли працюють як перенос рядка?

У CommonMark і GitHub Flavored Markdown так. Але редактори й інструменти Git часто прибирають пробіли в кінці рядків, і розрив мовчки зникає. Надійніша зворотна скісна риска чи <br>.

Як зробити перенос рядка в таблиці Markdown?

Використайте <br> усередині комірки. Два пробіли й зворотна скісна риска там не працюють, бо рядок таблиці — це один рядок тексту.

Інші запитання