MarkdownCo

Markdown to Confluence Converter

Вставьте или загрузите Markdown и получите вики-разметку Confluence, готовую для Data Center, Server или Jira. Заголовки, таблицы, блоки кода и ссылки преобразуются в соответствующие элементы вики-разметки; формулы LaTeX переносятся без изменений.

Вывод в вики-разметкеCode macros с тегами языкаФормулы LaTeX сохранены
document.md
confluence.txt

Confluence Wiki Markup

Результат обновляется по мере ввода. Нажмите Convert & Download, чтобы сохранить его как файл.

Связанные инструменты конвертации Markdown

Попробуйте другие конвертеры Markdown для вашего рабочего процесса

Как конвертировать Markdown в Confluence

От файла .md до готовой вики-разметки Confluence — три шага.

1

Добавьте Markdown

Вставьте Markdown в редактор или перетащите файл .md.

2

Проверьте вики-разметку

В правой панели вики-разметка Confluence отображается по мере ввода. Проверьте code macros и таблицы перед экспортом.

3

Конвертируйте и скачайте

Нажмите Convert & Download, чтобы сохранить вики-разметку как файл .txt и оставить её в истории.

Где применяется вики-разметка Confluence

Вики-разметка Confluence — это текстовый формат, который Confluence Data Center, Server и Jira распознают нативно. Ведение исходников в Markdown с конвертацией при экспорте позволяет держать файлы в git, а команде — читать их в Confluence.

Confluence Data Center and Server pages
Страницы Confluence Data Center и Server через Insert > Markup
Jira descriptions and comments
Описания и комментарии в Jira, где используется та же вики-разметка
Bulk migration into Confluence
Массовый перенос репозиториев с README и документацией в Confluence
Runbooks and technical notes
Публикация runbook'ов и технических заметок, написанных в Markdown

Как Markdown преобразуется в вики-разметку Confluence

Каждый элемент Markdown преобразуется в соответствующий элемент вики-разметки, а конвертация проверена на реальных технических документах с большим объёмом кода и формул.

Блоки кода становятся code macros

Блоки кода в тройных кавычках конвертируются в macros {code:language=...} с сохранением тега языка, поэтому подсветка синтаксиса работает в Confluence.

Code blocks become code macros

Таблицы и ссылки конвертируются без ошибок

Таблицы GFM преобразуются в строки ||header|| и |cell|; ссылки [текст](url) становятся [текст|url]. Вложенные списки сохраняют уровень вложенности.

Tables and links convert cleanly

Формулы LaTeX переносятся без изменений

Блоки $$ и инлайн-формулы $...$ распознаются и остаются в исходном виде — команды интервалов, переносы строк в матрицах и экранированные фигурные скобки сохраняются, поэтому макрос для формул в Confluence сможет их отрендерить.

LaTeX math passes through untouched

Заголовки, цитаты и разделители преобразуются один к одному

Заголовки # становятся h1.–h6., цитаты становятся блоками {quote}, горизонтальные линии — ----. Структура документа сохраняется построчно.

Headings, quotes, and rules map 1:1

Вопросы и ответы: Markdown to Confluence

Здесь собраны ответы про вывод в вики-разметке, code macros, обработку формул и совместимость с Confluence Cloud.

Как конвертировать Markdown в вики-разметку Confluence?

Вставьте Markdown в редактор или загрузите файл .md. Предпросмотр вики-разметки появляется в панели результата по мере ввода. Чтобы получить результат, нажмите Convert & Download — разметка будет сохранена как файл .txt в истории конвертаций. Для этого нужно войти в аккаунт, списываются кредиты; подробности — на странице с ценами.

В каком формате этот инструмент выдаёт результат?

Вики-разметка Confluence (wiki markup) — текстовый синтаксис, который распознают Confluence Data Center, Server и старый редактор (заголовки h1., *жирный*, macros {code}, строки ||table||). Это то же семейство разметки, которое Jira использует в описаниях и комментариях.

Работает ли результат в Confluence Cloud?

Частично. В новом редакторе Confluence Cloud убрали опцию Insert > Markup, поэтому вставить вики-разметку туда нельзя. Вики-разметка работает в Data Center, Server, старом редакторе Cloud и в Jira. Если вы используете новый редактор Cloud, вставляйте Markdown напрямую — при вставке большая часть синтаксиса конвертируется автоматически.

Как конвертируются блоки кода?

Блоки кода в тройных кавычках становятся macros {code:language=...}. Идентификатор языка после открывающих кавычек (```python, ```js) переносится в macro, поэтому Confluence применяет корректную подсветку синтаксиса. Блоки без тега языка становятся {code:language=text}.

Что происходит с формулами LaTeX?

Они переносятся побайтово, без изменений. Конвертер распознаёт блоки $$ и инлайн-формулы $...$ перед конвертацией и восстанавливает их в исходном виде после, поэтому команды интервалов вроде \, и переносы строк в матрицах \\ не повреждаются. В Confluence нет встроенного рендеринга формул — используйте результат вместе с macro-приложением для LaTeX на вашем инстансе.

Поддерживаются ли таблицы Markdown?

Да. Таблицы в формате GitHub Flavored Markdown конвертируются в разметку таблиц Confluence: строки заголовков становятся ячейками ||header||, а строки данных — строками |cell|. Синтаксис выравнивания столбцов отбрасывается, так как таблицы в вики-разметке его не поддерживают.