Эта документация вводит в заблуждение. Markdown сам по себе не является надмножеством HTML. Документация для оригинального проекта Markdown довольно ясна :
Уценка не является заменой HTML или даже близко к нему. Его синтаксис очень мал, соответствует только очень небольшому подмножеству тегов HTML. Идея состоит в том, чтобы не создать синтаксис, который облегчает вставку тегов HTML. На мой взгляд, HTML-теги уже легко вставить. Идея Markdown - облегчить чтение, запись и редактирование прозы. HTML является издательским форматом; Уценка - это запись формат. Таким образом, синтаксис форматирования Markdown решает только проблемы, которые могут быть переданы в виде простого текста.
Сегодня существует несколько разновидностей Markdown, многие из которых добавляют функции, которых не было в исходной версии, такие как таблицы и выделенные синтаксисом кодовые блоки. Это не меняет фундаментального факта, что Markdown охватывает подмножество HTML.
(Технически говоря, Markdown также не является подмножеством HTML. *
, например, не имеет никакого особого значения в HTML. Не преобразованные документы Markdown могут быть правильно сформированным HTML, но семантика очень разная. Но синтаксис Markdown отображается на подмножество тегов HTML.)
Однако в следующем абзаце оригинальной документации написано:
Для любой разметки, на которую не распространяется синтаксис Markdown, вы просто используете сам HTML. Нет необходимости вводить предисловие или разделять его, чтобы указать, что вы переходите с Markdown на HTML; вы просто используете теги.
Поскольку вы можете напрямую использовать HTML в Markdown, можно считать расширенным набором HTML. Например, это действительная уценка:
# My awesome title
I <em>really</em> like coffee
Если вы пропустите HTML-документ через соответствующий процессор Markdown, он должен выйти на другую сторону без изменений. Возможность напрямую использовать HTML в Markdown очень похожа на то, как можно напрямую использовать C в C ++. Это может быть то, что означает документация Jupyter.