← Blog'a dön

Confluence Sayfalarını Markdown'a Nasıl Aktarılır (2026 Kılavuzu)

· Save Team
confluencemarkdowndocumentationenterprisemigration

Confluence sizi gitmek istemez. Atlassian içeriğinizi tescilli bir XML formatında depolar, Markdown dışa aktarımı sunmaz ve toplu çıkartmayı çok zor hale getirir. Confluence’dan temiz metin almaya çalışıp hayal kırıklığını yaşadıysanız, ne demek istediğimizi biliyorsunuzdur.

Bu kılavuz, Confluence sayfalarını Markdown’a aktarmak için tek seferlik sayfalardan tüm space’lere kadar her yöntemi kapsar.

Confluence’ı Neden Markdown’a Aktarmalısınız?

Ekipler birçok nedenle Confluence’dan ayrılır:

  • Yeni bir araca geçiş --- Markdown bekleyen Notion, GitBook, Docusaurus veya statik site üreticisine geçiş
  • Bilgi tabanını arşivleme --- Atlassian lisansı sona ermeden önce ekip belgelerini koruma
  • AI bilgi tabanı oluşturma --- Claude, ChatGPT veya dahili bir LLM’e temiz belgeler besleme
  • Kritik belgeleri yedekleme --- Atlassian’ın sunucularına bağlı olmayan taşınabilir bir kopya
  • Satıcı bağımlılığından kurtulma --- içeriğinize evrensel bir formatta sahip olma

Yöntem 1: Save (Tekil Sayfalar için En Hızlı)

Save, herhangi bir Confluence sayfasını tek tıklamayla temiz Markdown’a dönüştüren bir Chrome uzantısıdır.

Nasıl çalışır:

  1. Chrome’da herhangi bir Confluence sayfasını açın
  2. Save uzantısı simgesine tıklayın
  3. Bir .md dosyası anında indirilir

Ne elde edersiniz:

  • Başlık hiyerarşisiyle tam sayfa metni
  • Markdown tabloları olarak biçimlendirilmiş tablolar
  • Dil etiketli kod blokları
  • Blok alıntıya dönüştürülmüş bilgi panelleri
  • Genişlet/daralt bölümleri (tamamen genişletilmiş)
  • Temiz meta veri: sayfa başlığı, space adı, son güncelleme tarihi
  • Dahili ve harici bağlantılar korunmuş

Ne kaldırılır:

  • Atlassian makroları ve tescilli biçimlendirme
  • Navigasyon elementleri, kenar çubukları ve menüler
  • WYSIWYG editör kalıntıları
  • Satır içi stiller ve CSS

En iyi kullanım alanı: Tekil sayfaları veya küçük grupları kaydetmek. 5-50 sayfa gerekiyorsa bu en hızlı yöntemdir.

Örnek Çıktı

Tipik bir Confluence çalışma kitabından:

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

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

### 2. Run Database Migrations

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

Yöntem 2: Confluence’ın Yerleşik Dışa Aktarması (HTML, Sonra Dönüştür)

Confluence sayfaları HTML olarak dışa aktarabilir. Ardından Pandoc gibi bir araç kullanarak HTML’yi Markdown’a dönüştürebilirsiniz.

Adımlar:

  1. Sayfaya gidin → … menüsü → PDF/Word/HTML’ye aktar
  2. HTML dışa aktarmayı seçin
  3. Pandoc ile dönüştürün: pandoc input.html -o output.md

Bu yaklaşımın sorunları:

  • HTML dışa aktarması Atlassian’ın CSS, makrolarını ve satır içi stillerini içerir
  • Tablolar genellikle dönüştürme sırasında bozulur
  • Kod blokları dil etiketlerini kaybeder
  • Görseller ileride bozulabilecek Confluence URL’lerine referans verir
  • İç içe sayfalar tüm space’i dışa aktarmayı gerektirir

Bu yöntem çalışır ama manuel temizleme gerektiren dağınık çıktı üretir.

Yöntem 3: Space Dışa Aktarma + Toplu Dönüştürme

Tüm bir Confluence space’ini dışa aktarmak için:

  1. Space Settings → Content Tools → Export gidin
  2. HTML formatı seçin
  3. ZIP arşivini indirin
  4. HTML dosyalarını Markdown’a toplu dönüştürmek için bir script kullanın

Sorun: Confluence space dışa aktarmaları, bozuk göreli bağlantılar, yinelenen navigasyon elementleri ve Atlassian’a özgü işaretleme içeren derin iç içe HTML üretir. Bunu programlı olarak temizlemek bir hafta sonu projesidir.

Yöntem 4: Confluence REST API

Programatik erişim için:

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

Bu size ham depolama formatını verir (XHTML benzeri). Şunları yapmanız gerekir:

  1. Atlassian depolama formatını ayrıştırma
  2. Makroları, yerleştirmeleri ve özel elementleri işleme
  3. Markdown’a dönüştürme
  4. Her sayfa için tekrar etme

En iyi kullanım alanı: Taşıma hattı oluşturan mühendislik ekipleri. Çoğu kullanım senaryosu için fazla karmaşık.

Hangi Yöntemi Kullanmalısınız?

SenaryoEn İyi Yöntem
1-50 sayfayı hızlıca kaydetSave uzantısı --- sayfa başına bir tıklama
Tüm space’i arşivleSpace dışa aktarma + Pandoc --- toplu ama dağınık
Taşıma hattı oluşturREST API --- programatik ama karmaşık
Temel belgelerin hızlı yedeğiSave uzantısı --- en temiz çıktı
Belgeleri LLM’e besleSave uzantısı --- Markdown LLM’e özgü

Çoğu insan için Save cevaptır. Sıfır kurulumla en temiz Markdown’ı üretir ve Confluence’ın tescilli biçimlendirmesini otomatik olarak işler.

Confluence İçeriğinizi Kullanışlı Hale Getirme

Sayfalarınızı Markdown’a aktardıktan sonra şunları yapabilirsiniz:

  • Her şeyi arayın grep, VS Code veya Obsidian ile
  • Claude veya ChatGPT’ye besleyerek belgeleriniz hakkında anında yanıt alın
  • Git’te sürüm kontrolü --- belgelerinizdeki değişiklikleri kod gibi takip edin
  • Herhangi bir araca aktarın --- Notion, Obsidian, GitBook, Docusaurus veya statik site üreticisi
  • Sonsuza kadar saklayın --- Markdown dosyaları düz metindir. 50 yıl sonra da okunabilir olacak

Başlarken

Save’i yükleyin ve hemen bir Confluence sayfasında deneyin. Başlamak ücretsizdir ve saniyeler içinde temiz Markdown göreceksiniz.

Confluence’tan kaçmak zor olmak zorunda değil. Save herhangi bir sayfayı tek tıklamayla temiz Markdown’a dönüştürür.