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