Этот конвертер Markdown в Confluence переписывает текст в вики-разметку для окна вставки разметки или в формат хранения Confluence (XHTML) для REST API. Вставьте Markdown или откройте файл .md и скопируйте результат.
Обновлено:
Как это работает
Вставьте Markdown
Вставьте README или инструкцию, откройте файл .md, откройте его по ссылке или нажмите «Загрузить пример».
Выберите формат
В поле «Формат результата» — вики-разметка для редактора или формат хранения для API; там же настраиваются примечания и языки кода.
Вставьте в Confluence
В редакторе нажмите + → Markup, выберите Confluence wiki, вставьте текст и подтвердите. Для API отправьте XML в формате хранения как тело страницы.
Возможности
Два формата результата
Вики-разметка (h2., {code}, ||таблицы||) и формат хранения с элементами ac:structured-macro для кода, панелей info и списков задач.
Примечания становятся макросами
Уведомления GitHub вроде > [!NOTE] или > [!WARNING] превращаются в макросы {info}, {tip}, {note} и {warning}, а не в обычные цитаты.
Код с языком и заголовком
Блок кода сохраняет язык (переименованный в тот, что подсвечивает Confluence) и title="…" из строки после ```.
Честные предупреждения
То, что Confluence передать не может, например сноски или выравнивание столбцов в вики-разметке, перечисляется под результатом.
Ограничения и конфиденциальность
Файлы до 10 MB. Тексты больше 256 KB конвертируются в фоновом потоке, поэтому страница не зависает. Ничего не загружается на сервер: конвертация идет в вашем браузере, а «Открыть по ссылке» скачивает файл напрямую с указанного адреса. Подробнее — на странице о конфиденциальности.
Что меняется при переносе в Confluence
Одиночный перенос строки внутри абзаца вики-разметка Confluence считает принудительным, поэтому строки Markdown, перенесенные для удобства чтения, склеиваются через пробел. В списках не может быть блоков кода и второго абзаца: такие блоки ставятся сразу после пункта, и показывается предупреждение. Сноски Markdown становятся надстрочными номерами с примечаниями в конце — макроса сносок в Confluence нет.
Изображения сохраняют свой URL; вложения нужно загрузить на страницу отдельно. Формулы остаются моноширинным TeX, если на вашем сайте не установлено приложение для LaTeX.
Частые вопросы
Как вставить Markdown в Confluence?
Сконвертируйте текст здесь, затем в редакторе Confluence выберите Insert → Markup, отметьте Confluence wiki, вставьте текст и нажмите Insert.
Поддерживает ли Confluence Cloud Markdown?
Редактор Cloud распознает часть Markdown при наборе, но во вставленных документах теряются таблицы, языки кода и панели. Вики-разметка через окно вставки разметки их сохраняет.
Что такое формат хранения?
Это формат на основе XHTML, в котором Confluence хранит страницы. Он нужен для REST API и инструментов, публикующих страницы из Git.
Поддерживаются ли списки задач?
Да. В формате хранения они становятся настоящими задачами Confluence, а в вики-разметке синтаксиса задач нет, поэтому получаются символы ☐ и ☑.
Можно ли добавить оглавление?
Включите «Оглавление» — в начало страницы добавится макрос {toc}.
Загружается ли документ на сервер?
Нет. Конвертация целиком выполняется в браузере.