Jak Eksportować Strony Confluence do Markdown (Przewodnik 2026)

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:

1. Otwórz dowolną stronę Confluence w Chrome
2. Kliknij ikonę rozszerzenia Save
3. 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:

1. Przejdź do strony → menu … → Eksportuj do PDF/Word/HTML
2. Wybierz eksport HTML
3. 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:

1. Przejdź do Ustawień Space’a → Narzędzia Treści → Eksportuj
2. Wybierz format HTML
3. Pobierz archiwum ZIP
4. 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ł:

1. Sparsować format przechowywania Atlassian
2. Obsłużyć makra, osadzenia i specjalne elementy
3. Skonwertować do Markdown
4. 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.