Word ke Confluence Markdown: Impor Dokumen ke Wiki Tim Anda

Confluence adalah salah satu wiki tim yang paling banyak digunakan, dan banyak organisasi memiliki perpustakaan dokumen Word yang termasuk dalam Confluence. Mengkonversi dokumen-dokumen itu dengan bersih lebih rumit dari yang terlihat Confluences Markdown dukungan memiliki quirks. Panduan ini menunjukkan kepada Anda yang paling dapat diandalkan Word sampai Confluence alur kerja.

Apakah Confluence mendukung Markdown?

Confluence memiliki dukungan Markdown parsial, tetapi tergantung pada implementasi:

• Confluence Awan mendukung makro Markdown dan dapat merender Markdown dalam konteks tertentu, tetapi editor asli adalah formatnya sendiri
• Confluence Data Center / Server juga memiliki makro Markdown
• Atlassian Rovo / Editor Baru Versi terbaru telah meningkatkan dukungan paste Markdown

Metode yang paling dapat diandalkan di semua versi adalah mengkonversi Word ke Markdown dengan WordToMD, lalu tempelkan isi Markdown menggunakan fitur import Confluences Markdown.

Metode 1: Tempelkan Markdown melalui Confluence Editor

Langkah-langkah

1. Konversi dokumen Word Anda di WordToMD dan klik Copy Markdown
2. Dalam Confluence, buka editor halaman
3. Dari menu Masuk (+ ikon), pilih Markup atau Makro Lainnya → Markup
4. Pilih Markdown sebagai bahasa
5. Tempelkan isi Markdown
6. Klik Masukkan

Makro Markup/Markdown membuat konten sebagai teks kaya dalam halaman. Ini tidak mengkonversi ke blok Confluence asli, tetapi merender judul, tabel, dan daftar dengan benar.

Metode 2: Word Impor file

Confluence Cloud memiliki fitur import Word:

1. Buat halaman Confluence baru
2. Klik menu ... → Impor Word Dokumen
3. Pilih file .docx Anda

Ini bekerja untuk dokumen sederhana tetapi cenderung kehilangan format yang kompleks. Jalur Markdown memberikan kontrol yang lebih.

Metode 3: Konversi ke HTML

Beberapa tim lebih memilih HTML sebagai format menengah karena Confluences editor menerima HTML paste:

1. Konversi Word doc ke Markdown dengan WordToMD
2. Mengkonversi Markdown ke HTML menggunakan alat online atau marked library
3. Beralih ke Confluence Source Editor (Ctrl+Shift+D atau dari toolbar)
4. Tempelkan HTML

Pendekatan ini mempertahankan format yang lebih kompleks tetapi lebih banyak langkah.

Kompatibilitas Pemformatan

Meja Pengendalian

Word tabel dikonversi ke GFM pipa sintaksis melalui WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

Untuk operasi tabel yang lebih kompleks, lihat Markdown Tabel: Panduan Lengkap.

Blok Kode di Confluence

Confluence memiliki makro Code Block sendiri yang menawarkan penandai sintaksis dan nomor baris. Setelah mengimpor Markdown konten, Anda mungkin ingin mengganti blok kode dari makro Markdown dengan makro Confluence Code Block asli untuk kebolehbacaan yang lebih baik:

1. Mengedit halaman
2. Temukan bagian kode
3. Masukkan makro blok kode
4. Tetapkan bahasa untuk penekanan sintaksis
5. Tempelkan kode

Referensi: Markdown Panduan Blok Kode untuk sintaksis standar.

Atlassian Confluence dan ADF

Confluence Cloud secara native menggunakan Format Dokumen Atlassian (ADF) skema JSON untuk konten kaya. Makro Markdown berada di atas ini. Untuk impor program, Confluence REST API menerima ADF secara langsung. Jika Anda membangun pipa otomatis, ubah Word → Markdown → ADF menggunakan perpustakaan yang tersedia.

Bagi kebanyakan tim, alur kerja manual lebih sederhana dan lebih cepat.

Memindahkan Perpustakaan Dokumen

Jika Anda mengimigrasi puluhan dokumen Word ke Confluence:

1. Mengkonversi semua file menggunakan WordToMD (atau batch dengan Pandoc untuk volume besar)
2. Buat ruang Confluence dan rencanakan hierarki halaman
3. Mengimpor halaman dalam bagian, mengelompokkan dokumen terkait di bawah halaman induk
4. Tambahkan fitur khusus Confluence setelah impor: label, pembatasan halaman, @mentions

FAQ

Dapatkah saya menggunakan Markdown secara asli di Confluence tanpa makro? Dalam beberapa konfigurasi Confluence Cloud dengan Editor Baru, Anda dapat mengetik pintasan Markdown dan mereka secara otomatis mengonversi (e.g., mengetik ## menciptakan H2). Tapi untuk menempelkan dokumen yang dikonversi, makro Markdown lebih dapat diandalkan.

Pemformatan judul saya hilang setelah impor semuanya terlihat seperti teks tubuh. Ini biasanya berarti makro Markdown tidak aktif. Markdown harus berada di dalam blok makro Markup/Markdown, tidak dilampirkan sebagai teks biasa ke dalam editor standar.

Tabel ditampilkan sebagai karakter pipa mentah. Masalah yang sama konten harus berada di dalam makro Markdown, bukan di editor teks standar.

Apakah ada cara otomatis untuk menyinkronkan Word dokumen ke Confluence halaman? Ya alat seperti Confluences Fitur Dokumen Eksternal, Versi Scroll, atau script khusus menggunakan Confluence REST API dapat menyinkronkan Markdown file ke halaman secara otomatis.

Kesimpulan

Yang paling bersih Word sampai Confluence alur kerja adalah: mengkonversi dengan WordToMD, lalu impor melalui makro Markdown. Untuk dokumen yang kompleks atau migrasi massal, pendekatan intermediate HTML atau otomatisasi REST API memberikan lebih banyak kontrol. Bagaimanapun, penggunaan gaya judul Words yang tepat sebelum konversi memastikan hierarki halaman tetap utuh.