Markdown ke Penukar HTML
Ubah teks Markdown kepada kod HTML sedia pengeluaran dengan sokongan pratonton langsung.
Ubah teks Markdown kepada kod HTML sedia pengeluaran dengan sokongan pratonton langsung.
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.
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.
Tampal Markdown, dapatkan HTML.
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.