Текст в Markdown

Пока вы набираете текст или вставляете его в редактор слева, справа собирается готовый текст в Markdown. На каждой правке он пересобирается заново. Поле справа доступно только для чтения, поправить можно лишь в редакторе. Оттуда результат копируется кнопкой «Скопировать Markdown» или сохраняется кнопкой «Скачать .md» в файл tekst.md.

Что во что превращается

Страница переводит каждое оформление в свой знак разметки. Заголовок становится строкой с #, ## и так далее по уровню. Жирный даёт **, курсив записывается как * или _, зачёркнутый обозначается ~~. Список превращается в строки с маркером, вложенный сдвигается отступом, нумерованный получает 1. в начале. Цитата помечается знаком >, ссылка записывается как [подпись](адрес). Пункт списка с флажком становится - [x], без флажка — - [ ]. Таблица собирается из строк со знаком | и строки из дефисов под шапкой, блок кода ограждается тремя обратными кавычками либо отмечается отступом.

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

Решётка в начале строки получает обратную косую черту впереди, иначе строка читалась бы заголовком. Экранирование сделано ради того, чтобы разметка читалась обратно тем же текстом.

Зачем менять настройки вида разметки

Блок «Вид разметки» задаёт, какими знаками записывать одно и то же: заголовки, маркер списка, курсив, блок кода, перенос строки, объединённые ячейки таблицы. Названия вариантов видны на экране, но часть ограничений на экране не написана. Подчёркивание для заголовков годится на уровнях 1 и 2, глубже всегда идут решётки. У блока кода с указанным языком ограда из кавычек ставится всегда. Вариант переноса «Два пробела» на конце строки глазами не различить.

Не знаете, что выбрать, оставьте как стоит. Менять настройки имеет смысл, когда принимающая сторона читает разметку по-своему, и выбор делается под неё.

Вставка из Word и Google Docs

Вместе с текстом Word приносит лишние служебные записи: классы mso, пустые теги, неразрывные пробелы. Список из Word часто вставляется абзацами один за другим, с маркером-знаком «·» прямо в тексте. Галочка «Чистить вставку из Word и Google Docs» убирает лишнее, собирает абзацы обратно в список и снимает знаки.

В Google Docs жирный и курсив заданы стилем, и чистка превращает стиль в тег, иначе выделение пропадает. Жирное внутри заголовка становится обычным текстом, потому что заголовок в Markdown и так выделен. Когда чистка прошла, под полем появляется заметка. Если галочка снята, вставка остаётся как есть.

Если вставилось криво, очистите редактор кнопкой «Очистить» и вставьте текст заново с включённой галочкой. Для результата в виде кода HTML используйте визуальный редактор HTML: это тот же редактор, но с кодом на выходе.