Когда Markdown преобразуется не так, как вы задумали, обычно виноваты несколько частых ошибок. Как только вы знаете причину, большинство из них исправляются одной строкой.
Самая частая ошибка — пробел между символом и текстом. Заголовку нужен пробел между # и текстом (#Заголовок ✗ / # Заголовок ✓), а спискам нужен пробел между - и текстом. Также безопаснее оставлять пустую строку сверху и снизу от блочных элементов — заголовков, списков, цитат и блоков кода.
Переносы строк — ещё один частый источник путаницы. В Markdown одиночный Enter не разрывает строку. Чтобы перенести строку, поставьте два пробела в конце; чтобы разделить абзацы, оставьте одну пустую строку.
Если специальный символ ошибочно принимается за форматирование, экранируйте его, поставив перед ним обратную косую черту (\). Если таблица или список задач не отображаются, проверьте, поддерживает ли целевая платформа GFM, — а если сомневаетесь, вставьте это в AG MD, чтобы своими глазами увидеть реальный результат преобразования.