Как сохранять страницы Confluence в формате Markdown
· Save Team
confluencedocumentationwikienterprise
Confluence — место, где живут корпоративные знания, и откуда их почти невозможно извлечь. Проприетарный формат хранения Atlassian, неуклюжий экспорт и WYSIWYG-редактор делают извлечение чистого контента мучительным процессом. Вот как сохранять страницы Confluence в формате Markdown.
Зачем сохранять Confluence как Markdown?
Извлечь контент из Confluence — известная боль:
- Проприетарный формат — Confluence хранит контент в собственном XML-формате
- HTML-экспорт раздут — полон Atlassian-макросов, стилей и разметки
- Нет нативного экспорта в Markdown — этого варианта нет в меню экспорта
- Массовый экспорт — хаос — экспорт пространства даёт вложенный HTML с битыми ссылками
- Привязка к вендору — уйти с Confluence — это отдельный проект
Что Save захватывает из Confluence
Контент страницы
- Полный текст страницы с иерархией заголовков
- Таблицы (корректно отформатированные как Markdown-таблицы)
- Блоки кода с тегами языков
- Информационные панели и заметки (конвертируются в блок-цитаты)
- Разворачиваемые разделы (развёрнутый контент)
- Маркированные и нумерованные списки
- Внутренние и внешние ссылки
Пример вывода
# Runbook развёртывания — Production API
**Пространство:** Engineering
**Последнее обновление:** 12 марта 2026
---
## Чеклист перед развёртыванием
- [ ] Все CI-проверки проходят на main
- [ ] Миграции БД проверены и одобрены
- [ ] Feature flags настроены для поэтапного rollout
- [ ] Дежурный инженер определён и доступен
- [ ] Зафиксирован план отката
## Шаги развёртывания
### 1. Создать ветку релиза
\`\`\`bash
git checkout main && git pull
git checkout -b release/v2.4.1
git push -u origin release/v2.4.1
\`\`\`
### 2. Запустить миграции БД
| Окружение | Команда | Таймаут |
|-----------|---------|---------|
| Staging | `npm run migrate:staging` | 5 мин |
| Production | `npm run migrate:prod` | 15 мин |
> **Предупреждение:** Всегда запускайте миграции сначала на staging.
> Производственные миграции требуют одобрения от @devops.
Сценарии использования
Миграция с Confluence
- Сохраняйте страницы по одной как чистый Markdown
- Постепенно выстраивайте новую базу знаний
- Мигрируйте в Obsidian, Notion, GitBook или систему docs-as-code
- Не нужны дорогие инструменты миграции
Личное извлечение знаний
- Сохраняйте страницы, наиболее релевантные вашей работе
- Создайте переносимую справочную библиотеку
- Сохраняйте доступ к документации после ухода из компании
- Создавайте офлайн-копии критических runbook’ов
Очистка документации
- Сохраняйте существующие страницы, редактируйте в Markdown и переимпортируйте
- Используйте как отправную точку для переписывания документации
- Сравнивайте старую и новую версии в diff-инструменте
- Аудит качества документации по всему пространству
AI-поиск
- Сохраняйте страницы Confluence как Markdown для обработки AI
- Передавайте внутреннюю документацию AI-инструментам для улучшения поиска
- Создавайте Markdown-корпус для RAG (Retrieval-Augmented Generation)
- Получайте AI-ответы из корпоративной базы знаний
Советы для лучших результатов
- Сохраняйте из режима просмотра — не из редактора и не из обзора пространства
- Разворачивайте все разделы — кликните для разворачивания любых сворачиваемых макросов перед сохранением
- Вложения — Save захватывает текстовый контент; вложения скачивайте отдельно при необходимости
- Макросы — Confluence-макросы (Jira-ссылки, диаграммы) конвертируются в текст или ссылки
- Права доступа — Save может захватывать только страницы, которые вы можете просматривать
Начало работы
Установите Save из Chrome Web Store — освободите контент из Confluence.
Есть вопросы? Пишите на [email protected]