Markdown editor adalah lingkungan menulis berdampingan: kamu mengetik Markdown dalam teks biasa di satu sisi, dan pratinjau yang dirender diperbarui secara langsung di sisi lain. Format inilah yang menggerakkan file README di GitHub, portal dokumentasi, static site generator, platform blog, aplikasi catatan seperti Obsidian, dan alat chat seperti Discord dan Slack.
Inti dari Markdown adalah tetap mudah dibaca sebagai teks biasa dan menjadi HTML yang terstruktur saat dirender. Kamu menghabiskan lebih sedikit waktu mengutak-atik toolbar format dan lebih banyak waktu menulis, dan karena itulah penulis teknis dan developer menyukainya.
Kebanyakan Markdown editor modern mendukung *GitHub-Flavored Markdown* (GFM), yang menambahkan tabel, daftar tugas, code fence dengan petunjuk bahasa, autolink, dan coretan di atas spesifikasi asli CommonMark.
Yang akan kamu pelajari saat memakai Markdown editor
Markdown adalah teks biasa: bisa dibaca di editormu *dan* dirender sebagai HTML, tanpa toolbar atau format yang tersembunyi.
Judul, list, tautan, dan penekanan mencakup 90% tulisan pada umumnya. Tabel dan code fence mencakup sebagian besar 10% sisanya.
Code fence dengan petunjuk bahasa (```js, ```python) memicu syntax highlighting di banyak renderer.
Markdown dikonversi ke HTML saat dirender. Sumber yang sama menghasilkan output yang konsisten di mana pun renderer CommonMark/GFM dipakai.
Cara memakai Markdown editor langkah demi langkah
1
Mulai mengetik di panel kiri
Pakai # untuk judul, * atau _ untuk penekanan, dan - untuk list. Panel kanan diperbarui saat kamu mengetik.
2
Tambahkan struktur
Sisipkan judul, code fence, dan tabel untuk menata dokumen. Kebanyakan editor punya pintasan keyboard (Ctrl+B, Ctrl+I) untuk format yang umum.
3
Lihat pratinjau HTML yang dirender
Bandingkan pratinjau langsung dengan sumbernya. Kalau ada yang tidak tampil seperti yang kamu harapkan, biasanya sumbernya kekurangan baris kosong atau fence-nya tidak berpasangan.
4
Salin atau unduh
Salin sumber Markdown ke README-mu, atau salin HTML-nya ke email, CMS, atau tempat mana pun yang tidak mengenal Markdown.
Garis tegak (|) memisahkan kolom. Baris tanda hubung menyelaraskan kolom, dan karakter : mengatur perataannya (kiri, tengah, kanan). Tabel GFM tidak butuh lebar kolom yang presisi, karena yang penting hanya strukturnya.
GitHub menampilkan ini sebagai kotak centang interaktif di dalam issue dan PR. Berguna untuk checklist di dalam dokumen dan pelacakan proyek yang ringan.
Kesalahan umum soal Markdown
Lupa memberi baris kosong di sekitar list, tabel, dan code fence. Kebanyakan renderer butuh baris kosong untuk memulai blok baru.
Mencampur tab dan spasi di dalam list. Beberapa renderer diam-diam merusak indentasinya.
Menaruh HTML mentah di dalam code fence dan berharap HTML itu dirender. Code fence bersifat *literal*, dan memang itulah intinya.
Mengira semua Markdown sama. CommonMark, GFM, dan berbagai varian lainnya berbeda dalam hal-hal kecil (pemenggalan baris, autolink, HTML tertanam).
Memakai > untuk indentasi, bukan untuk kutipan. > *berarti* kutipan, jadi pilih cara lain untuk membuat indentasi.
FAQ Markdown Editor
Apa itu Markdown?
Markdown adalah bahasa markup ringan yang mengubah sintaks teks biasa yang sederhana (# heading, **bold**, [link](url)) menjadi HTML yang terformat. Markdown dirancang agar tetap mudah dibaca dalam bentuk sumbernya.
Bagaimana cara mengonversi Markdown ke HTML?
Tempel Markdown-mu ke Markdown editor dan salin HTML yang dirender, atau jalankan konverter seperti marked, markdown-it, atau pandoc. Kebanyakan static site generator melakukannya otomatis saat build.
Apa bedanya Markdown dan GitHub-Flavored Markdown?
GitHub-Flavored Markdown (GFM) menambahkan tabel, code block berpagar dengan petunjuk bahasa, daftar tugas, autolink, dan coretan di atas Markdown standar. Inilah dialek yang dipakai GitHub, GitLab, dan banyak platform dokumentasi.
Bisakah aku memakai HTML di dalam Markdown?
Bisa. Kebanyakan renderer meneruskan HTML mentah apa adanya. Ini berguna untuk menyisipkan hal yang tidak didukung Markdown secara bawaan (tata letak kustom, tag video), tetapi dokumenmu jadi terikat pada output HTML.
Apakah Markdown editor ini privat?
Ya. Editor Coddy merender Markdown sepenuhnya di browsermu, jadi teksmu tidak diunggah ke mana pun.