Что эквивалентно `.. raw: html` Sphinx в Markdown?

Как ясно сказано в правила (выделено мной):

For any markup that is not covered by Markdown’s syntax, you simply use HTML itself. There’s no need to preface it or delimit it to indicate that you’re switching from Markdown to HTML; you just use the tags.

The only restrictions are that block-level HTML elements — e.g. <div>, <table>, <pre>, <p>, etc. — must be separated from surrounding content by blank lines, and the start and end tags of the block should not be indented with tabs or spaces. Markdown is smart enough not to add extra (unwanted) <p> tags around HTML block-level tags.

Если вы обеспокоены тем, что Markdown может испортить содержимое вашего необработанного HTML, правила также гласят:

Note that Markdown formatting syntax is not processed within block-level HTML tags. E.g., you can’t use Markdown-style *emphasis* inside an HTML block.

Итак, пока ваши HTML-блоки правильно заключены в HTML-теги блочного уровня, Markdown оставит их в покое. Конечно, это не относится к встроенным элементам HTML, включенным в текст Markdown:

Span-level HTML tags — e.g. <span>, <cite>, or <del> — can be used anywhere in a Markdown paragraph, list item, or header. If you want, you can even use HTML tags instead of Markdown formatting; e.g. if you’d prefer to use HTML <a> or <img> tags instead of Markdown’s link or image syntax, go right ahead.

Unlike block-level HTML tags, Markdown syntax is processed within span-level tags.

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

А еще есть Commonmark, который не следует первоначальным правилам Markdown, а использует другой набор правил. В частности, Commonmark не требует пустых строк в необработанном блоке HTML, чтобы избежать синтаксического анализа Markdown. CommonMark будет рассматривать все как Markdown после первой пустой строки в необработанном блоке HTML. Однако, если вы используете парсер старой школы Markdown, а не парсер Commonmark, это не должно быть проблемой.

В качестве последнего предостережения, Markdown (не Commonmark) намного старше, чем HTML 5. Поэтому новые элементы блочного уровня, добавленные в HTML 5 (<section>, <article> и т. д.), не распознаются большинством реализаций Markdown как элементы блочного уровня. . Некоторые реализации были обновлены для добавления поддержки, но даже в этом случае нет согласованности между реализациями в отношении того, какие новые элементы следует рассматривать как блочные, поскольку эталонная реализация не была обновлена ​​для установки президента. Поэтому лучше придерживаться элементов, определенных как блочные в старых спецификациях HTML 4 и/или XHTML 1.