Подчёркивание в Markdown: что работает на GitHub и в других средствах отображения

В Markdown нет встроенного синтаксиса для подчёркивания текста. В CommonMark и GitHub Flavored Markdown _текст_ означает курсив, а __текст__ означает полужирное начертание. Для подчёркивания обычно нужна поддержка HTML или расширение конкретного приложения.

На GitHub документирован следующий вариант:

<ins>Обновлённый срок</ins> — пятница.

GitHub указывает <ins>...</ins> для подчёркнутого текста в документации по базовому форматированию. Это HTML-вариант, поддерживаемый платформой, а не новый разделитель Markdown, работающий повсюду.

Сравнение подчёркивания, полужирного и курсива

Исходный текст	Значение	Где ожидать поддержку
_важно_	Выделение, обычно курсив	CommonMark и GFM
__важно__	Сильное выделение, обычно полужирное	CommonMark и GFM
**важно**	Сильное выделение, обычно полужирное	CommonMark и GFM
<ins>добавленный текст</ins>	Вставленный текст, обычно подчёркнутый	Средства отображения с HTML; документировано GitHub
<u>аннотированный текст</u>	HTML-аннотация, обычно подчёркнутая	Средства отображения, разрешающие этот HTML-элемент

Выбирайте полужирное начертание или курсив, если нужно выделение. Например, **Срок: пятница** остаётся полезным в README, заметке и экспорте Markdown без зависимости от необработанного HTML.

В чём разница между ins и u?

Два тега могут выглядеть одинаково, но имеют разный смысл.

<ins> обозначает текст, вставленный в документ. Он подходит для правки, например недавно добавленного требования. Браузер обычно подчёркивает его, но таблица стилей может изменить внешний вид. См. справочник MDN по вставленному тексту.

Выпуск поддерживает <ins>импорт CSV и TSV</ins>.

<u> отмечает аннотацию, не являющуюся обычным выделением, например орфографическую ошибку. Современный HTML не определяет его как универсальный тег «сделать важным». См. справочник MDN по элементу u.

Проверьте написание слова <u>превет</u>.

Если вы управляете веб-сайтом и нужно исключительно визуальное подчёркивание, применяйте text-decoration: underline через CSS. Размещённая платформа Markdown может удалять атрибуты стиля или запрещать пользовательские стили, поэтому этот подход тоже не переносим.

Почему подчёркивание работает в одном редакторе и исчезает в другом?

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

Редактор MD File Viewer сейчас удаляет необработанные HTML-теги из пользовательского ввода. Если вставить <ins>добавленный текст</ins> или <u>аннотированный текст</u>, останутся слова без этих тегов, поэтому предпросмотр не подчеркнёт их. Используйте предпросмотр для поддерживаемого форматирования Markdown, а форматирование на основе HTML проверяйте там, где документ будет опубликован.

Если вы переносите HTML-документ в Markdown, конвертер HTML в Markdown поможет сохранить текст, заголовки, ссылки и списки. Подчёркивание и пользовательский CSS могут потеряться, поскольку в обычном Markdown нет соответствующего синтаксиса. Проверьте результат перед заменой исходного документа.

Примеры для README на GitHub

Для короткого дополнения в примечании к изменениям GitHub документирует такой HTML-вариант:

Эта версия добавляет <ins>необязательный шаг импорта</ins>.

Для срока или требования используйте выделение Markdown:

**Обязательно:** Добавьте строку заголовков в файл CSV.

Для перехода к ресурсу используйте ссылку:

[Прочитать инструкции по импорту](https://example.com/import)

Подчёркнутый текст может выглядеть как доступная для нажатия ссылка. Не создавайте у обычных надписей впечатление интерактивности, особенно если тот же абзац содержит настоящие ссылки. Руководство по ссылкам Markdown рассказывает о понятном тексте ссылок и ссылках по ссылочным меткам.

Частые ошибки с подчёркиванием

Двойные знаки подчёркивания делают текст полужирным. Замена **слово** на __слово__ меняет разделитель, а не смысл. Оба варианта означают сильное выделение.

Обратные кавычки показывают тег как код. Запись `<ins>текст</ins>` полезна в учебном материале, но намеренно показывает разметку вместо её отображения.

Сочетания клавиш относятся к приложению. Редактор форматированного текста может предлагать команду подчёркивания и сохранять HTML или собственный формат документа. Это не делает подчёркивание частью переносимого Markdown.

Заголовок с подчёркиванием — другое понятие. В этом исходном тексте дефисы создают заголовок второго уровня:

Примечания к выпуску
-------------

Они не подчёркивают фразу внутри абзаца. Для разделителя между разделами используйте горизонтальную линию Markdown с пустыми строками вокруг неё.

Часто задаваемые вопросы

Как подчеркнуть текст Markdown на GitHub?

Используйте <ins>текст</ins>, который GitHub документирует для подчёркивания. Для выделения, работающего и без поддержки HTML, используйте **текст** или *текст*.

Есть ли альтернатива подчёркиванию только на Markdown?

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

Сохранится ли подчёркивание при преобразовании Markdown в PDF или Word?

Только если конвертер сохраняет соответствующий HTML или расширение и поддерживает его оформление. Не предполагайте, что подчёркивание из предпросмотра одного приложения сохранится при экспорте другим. Проверьте итоговый файл или используйте стандартное полужирное выделение, когда важна переносимость.

Шпаргалка Markdown содержит краткий справочник по форматированию, для которого существует специальный синтаксис Markdown.