← Назад к блогу

Как сохранять страницы 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-ответы из корпоративной базы знаний

Советы для лучших результатов

  1. Сохраняйте из режима просмотра — не из редактора и не из обзора пространства
  2. Разворачивайте все разделы — кликните для разворачивания любых сворачиваемых макросов перед сохранением
  3. Вложения — Save захватывает текстовый контент; вложения скачивайте отдельно при необходимости
  4. Макросы — Confluence-макросы (Jira-ссылки, диаграммы) конвертируются в текст или ссылки
  5. Права доступа — Save может захватывать только страницы, которые вы можете просматривать

Начало работы

Установите Save из Chrome Web Store — освободите контент из Confluence.


Есть вопросы? Пишите на [email protected]