Fungsinya
Konverter Markdown ke HTML mengubah teks Markdown menjadi markup HTML yang bisa Anda tempel ke CMS, templat email, halaman statis, atau tempat mana pun yang menerima HTML tetapi tidak mendukung Markdown. Alat ini berguna untuk memublikasikan README di situs web, memindahkan catatan ke editor blog, atau memeriksa tag apa saja yang dihasilkan sepotong Markdown.
Hasilnya sama dengan HTML yang dibuat oleh perender Markdown populer: judul <h1> sampai <h6>, paragraf <p>, daftar <ul> dan <ol>, blok <pre><code> dengan class language- untuk penyorot sintaksis, dan markup <table> untuk tabel bergaya GitHub.
Cara menggunakan
- Ketik atau tempel Markdown, unggah file
.md, atau klik Contoh. - Pilih opsi yang Anda perlukan: GitHub Flavored Markdown, baris baru sebagai
<br>, ID judul untuk tautan jangkar, sanitasi untuk input yang tidak tepercaya, dan dokumen HTML lengkap alih-alih potongan. - Salin HTML atau unduh sebagai file
.html.
Hasilnya diperbarui saat Anda mengetik. Matikan opsi dokumen lengkap saat menempelkan hasil ke halaman yang sudah ada, dan nyalakan saat Anda membutuhkan file mandiri.
Contoh
Markdown ini:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
menjadi HTML berikut:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
Tips
- Secara default, HTML mentah di dalam Markdown dibiarkan apa adanya, seperti yang dilakukan sebagian besar perender. Aktifkan sanitasi setiap kali Markdown ditulis orang lain.
- Dengan ID judul aktif, Anda bisa menautkan ke suatu bagian dengan alamat seperti
page.html#installdan menyusun daftar isi dari judul-judulnya. - Blok kode mempertahankan bahasanya sebagai class, sehingga penyorot seperti Prism atau highlight.js mengenalinya tanpa kerja tambahan.
- Untuk melihat hasil render berdampingan, gunakan pratinjau Markdown. Untuk arah sebaliknya, gunakan konverter HTML ke Markdown.
FAQ
› Sintaksis Markdown apa yang didukung?
Seluruh CommonMark, seperti judul, penekanan, tautan, gambar, daftar, kutipan, kode, dan garis horizontal. Dengan GitHub Flavored Markdown aktif, Anda juga mendapat tabel dengan perataan kolom, daftar tugas, coretan, dan tautan otomatis untuk URL polos.
› Apa fungsi opsi sanitasi?
Opsi ini meng-escape semua HTML mentah dalam Markdown agar tampil sebagai teks alih-alih menjadi tag, dan menghapus tautan serta gambar yang URL-nya memakai skema berbahaya seperti javascript atau vbscript. Aktifkan saat Markdown berasal dari pengguna yang tidak Anda percayai, misalnya komentar atau postingan forum.
› Bagaimana ID judul dibuat?
Sama seperti GitHub. Teks judul diubah ke huruf kecil, tanda baca dihapus, dan spasi menjadi tanda hubung, sehingga Getting Started mendapat id getting-started. Judul yang berulang mendapat -1, -2, dan seterusnya, sehingga setiap jangkar tetap unik.
› Untuk apa opsi dokumen HTML lengkap?
Opsi ini membungkus hasil dalam halaman utuh dengan doctype, charset UTF-8, tag viewport, judul yang diambil dari judul tingkat satu pertama, dan stylesheet kecil yang mudah dibaca. Simpan sebagai file .html dan halaman akan terbuka rapi di browser mana pun.
› Apakah Markdown saya dikirim ke suatu tempat?
Tidak. Konversi berjalan di browser Anda dengan pustaka marked, dan tidak ada yang diunggah ke server.