Langkah 1: Muat naik DOC fail menggunakan butang di atas atau dengan seret dan lepas.
Langkah 2: Klik butang 'Tukar' untuk memulakan penukaran.
Langkah 3: Muat turun fail yang telah ditukar Markdown fail
DOC kepada Markdown FAQ Penukaran
Bagaimana saya menukar DOC ke bersih Markdown?
+
Muat naik DOC dan penukar memetakan strukturnya ke sintaks Markdown: tajuk menjadi tahap `#`, tebal/italik menjadi `**`/`*`, senarai menjadi `-`/`1.`, dan pautan menjadi `[text](url)`. Hasilnya adalah teks biasa mudah alih Markdown yang anda boleh jatuhkan ke README, artikel statik-tapak, wiki, atau editor Markdown mana-mana.
Adakah pengepala dan senarai dari DOC saya akan dipetakan ke sintaks Markdown?
+
Ya — tingkat pengepala dalam DOC ditukar kepada bilangan aksara `#` yang sepadan, dan senarai bernombor / bernombor / bersarang ditukar kepada penanda `-` dan `1.` dengan indentasi yang betul. Markdown menyimpan garisan dokumen supaya struktur boleh dibaca sebagai teks biasa.
Bagaimana jadual dari DOC saya diwakili dalam Markdown?
+
Jadual ditukarkan ke jadual paip Markdown berlauk GitHub (`| col | col |` dengan baris pemisah `---`), yang dihasilkan dengan betul pada GitHub, GitLab, dan kebanyakan penjana laman statik. Jadual sel yang sangat lebar atau digabungkan yang melebihi grid mudah Markdown dipermudah, kerana Markdown tiada sintaks sel digabungkan.
Apa yang berlaku kepada imej bila menukar DOC ke Markdown?
+
Imej terbenam dari DOC diekstrak ke folder saudara dan dirujuk dengan sintaks `` dalam Markdown, jadi Markdown menunjuk ke fail imej sebenar. Anda juga boleh memilih untuk menyimpan URL mutlak jika imej sudah dihost secara atas talian.
Adakah DOC ke Markdown menambah perkara hadapan YAML?
+
Secara opsyenal — penukar boleh mengeluarkan blok perkara depan YAML (`---` tajuk / penulis / tarikh `---`) pada bahagian atas Markdown dari metadata DOC, yang adalah tepat apa yang Jekyll, Hugo, dan penjana statik-tapak lain jangkakan. Matikan untuk badan-hanya bersih Markdown.
Adakah Markdown akan menggunakan pengepala ATX ('#') atau Setext?
+
Markdown menggunakan pengepala `#` gaya ATX secara lalai - konvensyen moden, disokong luas yang berfungsi dalam setiap rasa Markdown dan skala kepada semua enam tahap pengepala. Pengepala Setext (ditanda bawah) hanya menyokong dua tahap, jadi ATX adalah pilihan yang lebih selamat, lebih mudah alih.
Adakah DOC ke Markdown menyimpan pautan dan nota kaki?
+
Hiperpautan menjadi pautan `[text](url)` dalam baris dan, di mana DOC menandakan nota kaki sebenar, ianya ditukarkan kepada nota kaki gaya rujukan `[^1]' yang dihasilkan dengan betul pada platform yang menyokong sambungan. Nota superskript biasa disimpan sebagai teks dalam baris.
Bolehkah saya menukar DOC ke Markdown untuk README atau wiki GitHub saya?
+
Ya — output adalah Markdown Berlauk GitHub, jadi ianya dihasilkan dengan betul sebagai README, halaman wiki, isu, atau huraian PR pada GitHub dan GitLab. Jadual paip, senarai tugas, blok kod terbenam, dan pengepala `#` semua dipaparkan seperti yang dikehendaki bila anda menepek atau memasukkan Markdown.
Adakah DOC saya peribadi semasa penukaran?
+
Ya — fail DOC yang dimuat naik diproses dalam pekerja terisolasi dan dipadam dalam masa beberapa minit. Kami tidak pernah membaca, menyimpan, atau berkongsi kandungan. Lihat /privacy/.
Kenapa Markdown saya mempunyai tag HTML yang tercampur?
+
Markdown tidak boleh mengungkapkan setiap ciri yang dokumen kaya ada (teks berwarna, jadual kompleks, kotak teks), jadi penukar kembali ke HTML dalam baris untuk fragmen-fragmen itu bukannya melepaskan mereka — Markdown membenarkan HTML terbenam. Jika anda mahu Markdown murni, permudahkan format dalam DOC dahulu, atau aktifkan pilihan "strip HTML fallback".
Adakah DOC ke Markdown mengendali blok kod?
+
Ya — teks monospaced / praformat dalam DOC menjadi ```blok kod``` terbenam dalam Markdown, memelihara ruang kosong dan, di mana boleh dikesan, petua bahasa untuk penonjolan sintaks. Ini penting apabila menukar dokumen teknikal dan tutorial ke Markdown.
Bolehkah saya tukar DOC ke Markdown untuk penjana tapak statik seperti Hugo atau Jekyll?
+
Ya — benarkan perkara depan YAML dan Markdown keluar sedia untuk diletakkan dalam folder `content/` atau `_posts/`: tajuk dan tarikh dalam perkara depan, badan sebagai Markdown bersih, imej dalam folder saudara. Penukar sasaran tepat bentuk Hugo, Jekyll, Eleventy, dan Gatsby yang dijangkakan.
