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

Инструмент не выполняет <script>, но и не занимается полной очисткой HTML. На стороне сервера или в пайплайне публикации обязательно прогоняйте HTML через библиотеку‑санитайзер с белым списком (например, DOMPurify), запрещайте on*‑обработчики и опасные схемы URI и дополняйте всё строгой CSP‑политикой.

Старайтесь опираться на переносимые конструкции: переводите вложенные таблицы/списки в более простые таблицы‑пайпы и плоские списки; при необходимости вставляйте как «обычный текст», чтобы убрать span/style/class перед конвертацией. Выделите небольшой пример, добейтесь корректного результата на нём и затем примените те же приёмы к остальному тексту.