Confluence nie chce, żebyś odchodził. Atlassian przechowuje twoją treść w własnym formacie XML, nie oferuje eksportu do Markdown i utrudnia masową ekstrakcję. Jeśli kiedykolwiek próbowałeś wyciągnąć czysty tekst z Confluence, znasz tę frustrację.

Ten przewodnik obejmuje każdą metodę eksportowania stron Confluence do Markdown --- od pojedynczych stron po całe space’y.

Dlaczego Eksportować Confluence do Markdown?

Zespoły opuszczają Confluence z wielu powodów:

Migracja do nowego narzędzia --- przenoszenie się do Notion, GitBook, Docusaurus lub generatora stron statycznych, który oczekuje Markdown
Archiwizowanie bazy wiedzy --- zachowanie dokumentacji zespołu przed wygaśnięciem licencji Atlassian
Budowanie bazy wiedzy AI --- dostarczanie czystej dokumentacji do Claude’a, ChatGPT lub wewnętrznego LLM
Tworzenie kopii zapasowych krytycznych dokumentów --- posiadanie przenośnej kopii niezależnej od serwerów Atlassian
Ucieczka od uzależnienia od dostawcy --- posiadanie treści w uniwersalnym formacie

Metoda 1: Save (Najszybsza dla Pojedynczych Stron)

Save to rozszerzenie Chrome, które konwertuje dowolną stronę Confluence na czysty Markdown jednym kliknięciem.

Jak to działa:

Otwórz dowolną stronę Confluence w Chrome
Kliknij ikonę rozszerzenia Save
Plik .md pobiera się natychmiast

Co otrzymujesz:

Pełny tekst strony z hierarchią nagłówków
Tabele sformatowane jako tabele Markdown
Bloki kodu z tagami języka
Panele informacyjne przekonwertowane na cytaty blokowe
Sekcje rozwijane/zwijane (w pełni rozwinięte)
Czyste metadane: tytuł strony, nazwa space’a, data ostatniej aktualizacji
Zachowane linki wewnętrzne i zewnętrzne

Co jest usuwane:

Makra Atlassian i własne formatowanie
Chromka nawigacyjna, paski boczne i menu
Artefakty edytora WYSIWYG
Style inline i CSS

Najlepsze dla: Zapisywania pojedynczych stron lub małych partii. Jeśli potrzebujesz 5-50 stron, to najszybsza metoda.

Przykładowe Wyjście

Z typowego runbooka Confluence:

# Runbook Wdrożenia --- Produkcyjne API

**Space:** Engineering
**Ostatnia aktualizacja:** 12 marca 2026

---

## Lista Kontrolna Przed Wdrożeniem

- [ ] Wszystkie sprawdzenia CI zaliczone na `main`
- [ ] Migracje bazy danych przejrzane i zatwierdzone
- [ ] Feature flags skonfigurowane do stopniowego wdrożenia
- [ ] Plan cofnięcia udokumentowany

## Kroki Wdrożenia

### 1. Utwórz Gałąź Release

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Uruchom Migracje Bazy Danych

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

Metoda 2: Wbudowany Eksport Confluence (HTML, Następnie Konwersja)

Confluence może eksportować strony jako HTML. Możesz następnie przekonwertować HTML na Markdown za pomocą narzędzia takiego jak Pandoc.

Kroki:

Przejdź do strony → menu … → Eksportuj do PDF/Word/HTML
Wybierz eksport HTML
Konwertuj za pomocą Pandoc: pandoc input.html -o output.md

Problemy z tym podejściem:

Eksport HTML zawiera CSS Atlassian, makra i style inline
Tabele często psują się podczas konwersji
Bloki kodu tracą tagi języka
Obrazy odwołują się do URL-i Confluence, które mogą się zepsuć później
Zagnieżdżone strony wymagają eksportu całego space’a

Ta metoda działa, ale produkuje chaotyczne wyjście wymagające ręcznego czyszczenia.

Metoda 3: Eksport Space’a + Masowa Konwersja

Dla eksportowania całego space’a Confluence:

Przejdź do Ustawień Space’a → Narzędzia Treści → Eksportuj
Wybierz format HTML
Pobierz archiwum ZIP
Użyj skryptu do masowej konwersji plików HTML na Markdown

Problem: Eksporty space’ów Confluence produkują głęboko zagnieżdżony HTML z uszkodzonymi relatywnymi linkami, zduplikowanymi elementami nawigacyjnymi i markup specyficznym dla Atlassian. Programatyczne czyszczenie tego to projekt na weekend.

Metoda 4: REST API Confluence

Dla programatycznego dostępu:

curl -u [email protected]:API_TOKEN \
  "https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
  | jq -r '.body.storage.value' > page.html

To daje ci surowy format przechowywania (podobny do XHTML). Będziesz musiał:

Sparsować format przechowywania Atlassian
Obsłużyć makra, osadzenia i specjalne elementy
Skonwertować do Markdown
Powtórzyć dla każdej strony

Najlepsze dla: Zespołów inżynierskich budujących potok migracji. Przesada dla większości przypadków użycia.

Której Metody Powinieneś Użyć?

Scenariusz	Najlepsza Metoda
Szybkie zapisanie 1-50 stron	Rozszerzenie Save --- jedno kliknięcie na stronę
Archiwizowanie całego space’a	Eksport space’a + Pandoc --- masowy ale chaotyczny
Budowanie potoku migracji	REST API --- programatyczny ale złożony
Szybka kopia zapasowa kluczowych dokumentów	Rozszerzenie Save --- najczystsze wyjście
Dostarczanie dokumentów do LLM	Rozszerzenie Save --- Markdown jest natywny dla LLM

Dla większości ludzi Save jest odpowiedzią. Produkuje najczystszy Markdown bez konfiguracji i automatycznie obsługuje własne formatowanie Confluence.

Uczynienie Treści Confluence Użyteczną

Po wyeksportowaniu stron do Markdown możesz:

Przeszukiwać wszystko za pomocą grep, VS Code lub Obsidian
Dostarczyć do Claude’a lub ChatGPT dla natychmiastowych odpowiedzi na temat dokumentacji
Kontrolować wersje w Git --- śledzić zmiany w dokumentach jak w kodzie
Importować do dowolnego narzędzia --- Notion, Obsidian, GitBook, Docusaurus lub generator stron statycznych
Zachować na zawsze --- pliki Markdown to zwykły tekst. Będą czytelne za 50 lat

Pierwsze Kroki

Zainstaluj Save i wypróbuj teraz na stronie Confluence. Zaczynanie jest bezpłatne, a czysty Markdown zobaczysz w ciągu sekund.

Ucieczka z Confluence nie musi być bolesna. Save konwertuje dowolną stronę na czysty Markdown jednym kliknięciem.