Чому мій текст злипся в один абзац?

Бо за CommonMark одинарний перенос рядка — це пробіл, а не новий рядок. Увімкніть «Одинарний перенос рядка — це br», якщо звикли до поведінки GitHub, або лишіть порожній рядок між абзацами: так документ виглядатиме однаково в обох діалектах.

Чому в прев’ю немає моєї кнопки з onclick?

Обробники подій вирізаються перед показом — інакше сторінка виконувала б код із чужого тексту. Сам атрибут нікуди не подівся: перейдіть на вкладку «HTML-код», там вивід повний. Список того, що не потрапило у прев’ю, показано під результатом.

Таблиця з об’єднаними клітинками перетворилась на теги, а не на Markdown

Так і має бути. Таблиці GFM не мають синтаксису для colspan і rowspan, тож єдиний спосіб зберегти структуру — лишити HTML. Markdown це допускає, і у GitHub така таблиця відрендериться правильно.

Навіщо екранувати зірочки й підкреслення у тексті?

Щоб назва файлу на кшталт my_file_name не перетворилась на курсив при наступному рендері. Прапорець можна зняти, якщо ви впевнені, що у тексті немає символів, які Markdown вважає розміткою.

Чи збігається результат із тим, що покаже GitHub?

Для типової розмітки — так. Розбіжності можливі на крайніх випадках CommonMark: вкладені наголоси зі змішаними маркерами, посилання всередині посилань, блоки HTML сьомого типу. Це відомі межі: повна реалізація специфікації важить більше, ніж уся сторінка разом.

Текст завантажується на сервер?

Ні. Перетягнутий файл читається локально через File API, перетворення виконується у вкладці браузера. Мережевих запитів немає — це видно у вкладці Network інструментів розробника.

Markdown у HTML і назад: конвертер із живим прев’ю

Вставте Markdown — побачите готову сторінку і чистий HTML поруч. Вставте HTML — отримаєте Markdown, придатний для README чи статті у блозі. Обидва напрями працюють у вашому браузері: текст нікуди не надсилається і ніде не зберігається.

Markdown Перетягніть сюди .md — файл читається локально. Підтримано CommonMark у типовому обсязі плюс розширення GFM: таблиці, закреслення, списки задач.

Правила перетворення

Додавати id до заголовків Обгорнути у повний документ

Одинарний перенос рядка — це <br> За CommonMark один перенос усередині абзацу — звичайний пробіл, і саме так поводиться інструмент за замовчуванням. GitHub у коментарях і описах задач робить навпаки. Прапорець перемикає між цими двома звичками. Пропускати HTML із джерела Вимкнено — теги у Markdown екрануються і показуються як текст. Увімкнено — потрапляють у результат, але перед показом у прев’ю проходять через білий список: script, iframe, обробники on* та посилання javascript: вирізаються. У HTML-коді ви бачите те, що написали, у прев’ю — те, що безпечно показати.

Вставте Markdown вище — прев’ю з’явиться тут.

Вставте Markdown вище — HTML з’явиться тут.

HTML Перетягніть сюди .html — файл читається локально. Розбір іде через DOMParser, тому працює і з фрагментом, і з цілою сторінкою.

Заголовки

Маркер списку

Блоки коду

Що робити з рештою

Лишати теги без відповідника у Markdown Екранувати символи Markdown у тексті

Markdown

Вставте HTML вище — Markdown з’явиться тут.

Текст не залишає ваш браузер — перетворення виконується локально, без відправки на сервер.

Що саме підтримано

З боку Markdown — CommonMark у типовому обсязі плюс розширення GFM: заголовки решітками і підкресленням, абзаци, горизонтальні лінії; списки марковані, нумеровані та вкладені, зі щільним і розрідженим оформленням; списки задач у квадратних дужках; цитати, зокрема з лінивим продовженням рядка; код в огорожі з назвою мови та код відступом; таблиці GFM з вирівнюванням колонок; посилання, зображення, автопосилання, посилання на визначення внизу документа; жирний, курсив, закреслення, код у рядку, екрановані символи, жорсткий перенос. З боку HTML розбір іде через DOMParser самого браузера, тому працює і фрагмент, і ціла сторінка з head. Таблиці з об’єднаними клітинками у Markdown не переносяться — такого синтаксису там немає, тож вони лишаються тегами, і інструмент про це каже. Чого свідомо немає: підсвітки синтаксису у блоках коду, зносок, формул і директив конкретних генераторів статики. Це вже не Markdown, а діалект окремого інструмента.

Один перенос рядка: два різні Markdown

Найчастіше джерело розбіжностей між конвертерами — саме одинарний перенос усередині абзацу. За CommonMark це звичайний пробіл: два рядки склеюються в один абзац. Так поводяться Pandoc, генератори документації і більшість статичних сайтів. GitHub у коментарях, описах задач і рецензіях робить навпаки: кожен перенос стає тегом br. Саме тому текст, який гарно виглядав у задачі, після переносу в README злипається в суцільний абзац. Прапорець «Одинарний перенос рядка — це br» перемикає між цими двома звичками. За замовчуванням діє правило CommonMark.

Чому прев’ю показує не все, що є в HTML

Markdown за специфікацією дозволяє HTML усередині себе. Це зручно і водночас означає, що будь-який вставлений текст може містити виконуваний код. Популярні онлайн-переглядачі кладуть результат у innerHTML як є. Бібліотека marked, на якій вони збудовані, з четвертої версії не має вбудованої санітизації взагалі — тег script із чужого Markdown там просто виконається. Тут прев’ю будується вузлами DOM за білим списком: script, iframe, object, обробники подій виду onclick і посилання зі схемою javascript: до нього не потрапляють, а список вирізаного показується під результатом. У вкладці «HTML-код» ви бачите повний вихід без урізань — це текст, а не сторінка, і виконати його неможливо. Потрапити у прев’ю HTML із джерела може лише тоді, коли ви самі увімкнули відповідний прапорець. За замовчуванням теги екрануються і показуються як текст.