Penukar Percuma

Markdown ke Penukar HTML

Ubah teks Markdown kepada kod HTML sedia pengeluaran dengan sokongan pratonton langsung.

Tentang alat ini

Markdown ialah bahasa penanda ringan yang dicipta oleh John Gruber pada tahun 2004 untuk membolehkan penulis menghasilkan HTML berstruktur menggunakan konvensyen teks biasa: aksara cincang untuk tajuk, asterisk untuk penekanan, sempang untuk senarai, blok inden untuk kod. Format telah menjadi lalai untuk fail README, dokumentasi teknikal, draf blog, penjana tapak statik, dan sebarang konteks yang mana tulisan harus boleh dibaca sebagai teks biasa dan sebagai output yang diberikan. Menukar Markdown kepada HTML ialah langkah pemaparan yang mengubah sumber menjadi halaman web.

Penukar ini menggunakan pustaka bertanda, pemapar Markdown yang paling banyak diterima pakai dalam JavaScript. Marked menyokong CommonMark dan GitHub Flavoured Markdown (GFM), yang bermaksud jadual, blok kod berpagar, senarai tugas, coretan dan pemautan automatik semuanya berfungsi dengan betul selain ciri Markdown standard.

Output ialah HTML biasa — teg semantik untuk tajuk, perenggan, senarai, pautan dan imej, serta cangkuk kelas untuk blok kod di mana alat penyerlahan sintaks mengharapkannya. Output tampal dengan bersih ke dalam mana-mana CMS, dibenamkan dalam penjana tapak statik atau berfungsi sebagai .html kendiri. Tiada CSS atau JavaScript ditambah; menggayakan hasilnya diserahkan kepada konteks hiliran anda.

Mengapa Menukar Markdown kepada HTML

Markdown ialah format yang penulis dan pembangun lebih suka; HTML ialah format yang dipaparkan oleh penyemak imbas. Kebanyakan penjana tapak statik dan platform CMS menukar Markdown kepada HTML di belakang tabir, tetapi kadangkala anda memerlukan penukaran sebagai langkah kendiri — menampal ke dalam CMS yang tidak mempunyai sokongan Markdown, menjana HTML untuk e-mel, menghasilkan pratonton pantas atau mengekstrak output yang diberikan untuk pemprosesan selanjutnya.

HTML juga merupakan format kanonik untuk sebarang kandungan yang akhirnya akan dipaparkan dalam penyemak imbas. Surat berita e-mel yang dibina daripada draf Markdown, halaman dokumentasi yang dibenamkan dalam aplikasi HTML yang lebih besar dan catatan blog yang ditampal pada editor yang mengharapkan HTML semuanya mendapat manfaat daripada penukaran yang bersih.

Cara menggunakan

Tampal Markdown, dapatkan HTML.

  1. Tambah Markdown anda: Tampal teks Markdown ke dalam kawasan input atau lepaskan fail .md. Kedua-dua sintaks Markdown standard dan GitHub Flavored Markdown berfungsi.
  2. Tukar: Marked menghuraikan Markdown menjadi AST dan mengeluarkan HTML. Elemen sebaris standard (penekanan, kuat, pautan, kod, imej), elemen blok (tajuk, perenggan, senarai, petikan sekat) dan sambungan GFM (jadual, kod berpagar, senarai tugas, pautan automatik) semuanya dipaparkan dengan betul.
  3. Pratonton: Periksa HTML yang diberikan dalam panel pratonton. Sahkan blok kod, jadual dan elemen kompleks lain muncul seperti yang diharapkan.
  4. Salin atau muat turun: Salin HTML ke papan keratan untuk menampal ke dalam CMS atau simpan sebagai .html untuk kegunaan kendiri. Outputnya ialah HTML5 semantik tanpa gaya sebaris.

Kes Penggunaan Biasa

Butiran Teknikal

Ditanda menggunakan seni bina dua laluan. Lexer menandakan input ke dalam token peringkat blok (tajuk, perenggan, senarai, blok kod) dan token sebaris (penekanan, pautan, imej). Penghurai menjalankan aliran token dan mengeluarkan HTML, menggunakan cangkuk pemapar untuk setiap jenis token.

Pelanjutan Markdown Berperisa GitHub didayakan secara lalai: jadual (menggunakan sintaks paip), blok kod berpagar (tiga tanda belakang dengan pembayang bahasa), senarai tugas (- [ ] dan - [x]), coret (menggunakan tildes berganda) dan pautan auto URL. Blok kod mengeluarkan kod yang telah dibungkus dengan kelas bahasa pilihan untuk penyerlahan sintaks hiliran.

Pembersihan keluaran diserahkan kepada pengguna hiliran. Ditanda mengeluarkan apa sahaja input yang dihasilkan, termasuk HTML mentah yang dibenamkan dalam Penurunan Harga. Jika anda menerima input yang tidak dipercayai, jalankan output melalui DOMPurify atau pembersih HTML yang serupa sebelum memaparkan dalam penyemak imbas.

Amalan Terbaik

Soalan lazim

Adakah penukaran MARKDOWN kepada HTML mengubah kandungan?
Kandungannya dipelihara setepat mungkin. Walau bagaimanapun, sesetengah ciri khusus format mungkin tidak mempunyai persamaan langsung, jadi perbezaan pemformatan kecil boleh berlaku.
Apakah format HTML digunakan?
HTML (HyperText Markup Language) digunakan terutamanya untuk halaman web dan kandungan web.
Adakah terdapat sebarang batasan yang perlu diketahui?
Fail sehingga 50MB disokong. Fail yang sangat besar atau kompleks mungkin mengambil masa yang lebih lama untuk diproses. Semua penukaran berlaku dalam penyemak imbas anda, jadi kelajuan pemprosesan bergantung pada peranti anda.
Adakah penukaran ini selamat dan peribadi?
ya. Semua pemprosesan berlaku secara setempat dalam penyemak imbas anda. Data anda tidak pernah meninggalkan peranti anda — tiada muat naik pelayan, tiada pemprosesan awan, tiada pengumpulan data.
Adakah emoji disokong?
Emoji Unicode melalui terus (menaip emoji hati menunjukkan hati dalam output). GitHub-style :emoji: kod pendek tidak ditukar secara lalai; tambah sambungan jika anda memerlukannya.
Adakah Markdown saya dimuat naik ke pelayan?
Tidak. Ditanda berjalan dalam penyemak imbas anda; penukaran berlaku sepenuhnya pada peranti anda.
Bolehkah saya menambah gaya tersuai pada HTML?
Ya, selepas penukaran. Outputnya ialah HTML semantik biasa; gunakan CSS anda sendiri pada tajuk gaya, blok kod, jadual dan elemen lain.
Adakah ia menyokong nota kaki?
Standard CommonMark tidak menyatakan sintaks nota kaki. Sesetengah sambungan Markdown menyokong [^1] sintaks nota kaki; penukar ini mengikuti GFM, yang tidak termasuk nota kaki.