Конвертер выносок Markdown
Преобразуйте блоки выносок и примечаний между синтаксисом GitHub, Obsidian, Docusaurus и MkDocs.
Конвертер выносок Markdown
Блоки выносок — это оформленные на выделенном фоне примечания типа "Примечание", "Совет" или "Предупреждение" в README и на сайтах документации — каждая платформа пишет их по-своему. GitHub использует alert-ы в формате blockquote вида `> [!NOTE]`, Obsidian расширяет этот синтаксис пользовательскими заголовками и складываемыми стрелками, Docusaurus оборачивает содержимое в ограды `:::tip`, а MkDocs (и Material for MkDocs) использует отступленные блоки `!!! note` с `???` для складываемых блоков. При переносе документации между инструментами обычно приходится переписывать все выноски вручную — этот инструмент делает это автоматически.
Выберите исходный и целевой формат из панели опций, затем вставьте содержимое, написанное в исходном формате. Каждая найденная выноска разбирается и переписывается в целевой синтаксис; всё остальное в исходных данных — абзацы, заголовки, другой Markdown — проходит без изменений. Опция "Сохранять пользовательское название блока" сохраняет заголовок типа `> [!info] Слушайте внимательно` в Obsidian, когда целевой формат это поддерживает (GitHub не имеет синтаксиса для заголовков, поэтому сохранённый заголовок становится жирной первой строкой блока). "Сохранять складываемость" сохраняет маркеры складывания Obsidian `+`/`-` и синтаксис `???`/`???+` MkDocs где у целевого формата есть эквивалент; GitHub и Docusaurus не имеют складываемых выносок, поэтому этот параметр не влияет при преобразовании в эти форматы. "Приводить тип блока" отображает менее распространённые названия (important, caution, success, question…) на пять типов, которые поддерживает каждый формат: note, tip, warning, danger и info.
Тело каждой выноски сохраняется точно так же, как было написано, включая вложенные списки, встроенное форматирование, ссылки и огороженные блоки кода — это просто обычные строки внутри выноски. Несколько выносок в одном документе преобразуются за один проход, а переводы строк Windows и Unix обрабатываются одинаково.
Всё работает локально в вашем браузере; ваша документация никогда не загружается никуда. Скопируйте результат, скачайте как файл .txt или отправьте вывод обратно на вход для цепочки преобразований.