Markdown: Referensi Sintaksis Lengkap untuk Penulis dan Developer

Markdown ada di mana-mana. Ini adalah format penulisan default di GitHub, tulang punggung sebagian besar static site generator, bahasa native alat seperti Obsidian dan Notion, dan format yang dijangkau developer saat menulis README, dokumentasi, dan catatan teknis. Meskipun ada di mana-mana, banyak penulis dan developer hanya mempelajari dasar-dasarnya — tebal, miring, dan beberapa level heading — dan melewatkan fitur yang membuat Markdown benar-benar kuat untuk penulisan terstruktur.

Kamu bisa menulis dan mempratinjau Markdown secara instan menggunakan BrowseryTools Markdown Editor — gratis, tanpa daftar, semuanya tetap di browsermu.

Siapa yang Membuat Markdown dan Mengapa

Markdown dibuat oleh John Gruber, bekerja sama dengan Aaron Swartz, dan dirilis pada 2004. Tujuan yang dinyatakan Gruber adalah membuat format penulisan plain-text yang dapat dibaca apa adanya — sebelum rendering apa pun — dan yang dikonversi dengan bersih ke HTML yang valid. Namanya adalah permainan kata dari "markup language" (HTML adalah HyperText Markup Language), membalik konsepnya: alih-alih menambahkan sintaksis untuk mengontrol pemformatan, Markdown menggunakan kebiasaan tanda baca alami yang sudah dikembangkan orang dalam email plain-text.

Motivasinya bersifat praktis. HTML bertele-tele dan mengganggu untuk ditulis secara inline. Kalimat seperti <p>This is <strong>important</strong> text.</p> membutuhkan overhead mental yang signifikan dibandingkan This is **important** text. Gruber ingin blogger dan penulis fokus pada kata, bukan tag. Spesifikasi Markdown asli adalah skrip Perl yang mengkonversi file Markdown plain-text ke HTML.

Sintaksis Dasar

Sintaksis Markdown inti mencakup semua yang dibutuhkan sebagian besar penulis untuk dokumen terstruktur.

Heading

Gunakan tanda pagar untuk membuat heading. Satu tanda pagar untuk H1, dua untuk H2, hingga enam untuk H6. Sebagian besar panduan gaya merekomendasikan hanya satu H1 per dokumen (biasanya judul) dan menggunakan H2–H4 untuk hierarki konten.

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Penekanan dan Tebal

*italic* or _italic_
**bold** or __bold__
***bold and italic***
~~strikethrough~~

Tautan dan Gambar

[Link text](https://example.com)
[Link with title](https://example.com "Page title")
![Alt text](image.png)
![Alt text](image.png "Image title")

Daftar

Daftar tak berurut menggunakan tanda hubung, asterisk, atau tanda tambah. Daftar berurut menggunakan angka diikuti titik. Item yang diindentasi (2 atau 4 spasi) membuat daftar bersarang.

- Unordered item
- Another item
  - Nested item

1. First
2. Second
3. Third

Kode

Kode inline menggunakan backtick tunggal. Blok kode berpagar menggunakan backtick tiga kali lipat dengan identifier bahasa opsional untuk syntax highlighting.

Use `console.log()` for debugging.

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

Blockquote

> This is a blockquote.
> It can span multiple lines.
>
> > Nested blockquotes work too.

Garis Horizontal

Tiga atau lebih tanda hubung, asterisk, atau garis bawah pada satu baris sendiri membuat garis horizontal. --- adalah konvensi yang paling umum.

Sintaksis yang Diperluas

Spesifikasi Markdown asli melewatkan beberapa fitur yang sering dibutuhkan penulis. Sintaksis yang diperluas, didukung oleh sebagian besar prosesor modern, menambahkan kemampuan ini.

Tabel

| Column 1  | Column 2  | Column 3  |
|-----------|:---------:|----------:|
| Left      | Center    | Right     |
| aligned   | aligned   | aligned   |

Posisi titik dua di baris pemisah mengontrol perataan: kiri (default), tengah (titik dua di kedua sisi), atau kanan (titik dua di kanan).

Daftar Tugas

- [x] Write first draft
- [x] Peer review
- [ ] Final edits
- [ ] Publish

Catatan Kaki

Here is a claim that needs a citation.[^1]

[^1]: The supporting source or explanation goes here.

Varian Markdown: CommonMark, GFM, dan MDX

Spesifikasi Markdown asli memiliki ambiguitas — tempat di mana prosesor membuat keputusan berbeda tentang kasus tepi. Ini menghasilkan implementasi yang tidak kompatibel di berbagai alat. Beberapa upaya standardisasi muncul untuk menyelesaikan ini.

• CommonMark — spesifikasi ketat yang menyelesaikan setiap ambiguitas dalam spesifikasi Markdown asli dengan suite pengujian formal. Diadopsi oleh Discourse, Reddit, Stack Overflow, dan banyak lainnya. Varian yang paling dapat dioperasikan.
• GitHub Flavored Markdown (GFM) — ekstensi GitHub dari CommonMark yang menambahkan tabel, daftar tugas, strikethrough, autolink, dan URL literal. Jika kamu menulis file README atau komentar GitHub, kamu menggunakan GFM.
• MDX — Markdown yang diperluas dengan dukungan komponen JSX, digunakan secara luas di situs dokumentasi berbasis React (docs Next.js, Docusaurus, Astro). Memungkinkan mengimport dan menyematkan komponen React langsung di file Markdown.
• MultiMarkdown / Pandoc Markdown — ekstensi kaya fitur untuk penulisan akademis, dengan dukungan untuk kutipan, persamaan matematika (LaTeX), dan pemformatan tabel yang kompleks.

Di Mana Markdown Digunakan

• GitHub dan GitLab — file README, issues, pull request, wiki, dan komentar semuanya merender Markdown
• Notion — mendukung impor/ekspor Markdown dan subset pintasan Markdown untuk pemformatan inline
• Obsidian — aplikasi manajemen pengetahuan yang sepenuhnya dibangun di atas file Markdown dengan ekstensi wikilink
• Static site generator — Jekyll, Hugo, Gatsby, Astro, dan Next.js semuanya menggunakan Markdown atau MDX sebagai format konten default
• Platform dokumentasi — ReadTheDocs, GitBook, dan Docusaurus dibangun di sekitar Markdown
• Platform chat — Slack, Discord, dan Teams mendukung subset Markdown untuk pemformatan pesan
• Klien email — beberapa klien (Superhuman, HEY) mendukung input Markdown

Markdown vs Editor Rich Text

Editor rich text (WYSIWYG — What You See Is What You Get) seperti Google Docs, Microsoft Word, atau editor bawaan Contentful menampilkan output yang diformat saat kamu mengetik. Markdown menampilkan sumber mentah. Trade-off-nya nyata.

• Keunggulan Markdown — file plain-text, bekerja di editor mana pun, dapat dikontrol versi dengan git, tidak ada vendor lock-in, alur kerja cepat hanya dengan keyboard
• Keunggulan rich text — langsung visual, tidak ada sintaksis yang perlu dipelajari, lebih mudah bagi kontributor non-teknis, lebih baik untuk pemformatan kompleks (catatan kaki, komentar, perubahan yang dilacak)

Untuk penulisan teknis, dokumentasi developer, dan manajemen pengetahuan pribadi, portabilitas dan kompatibilitas version-control Markdown menjadikannya pilihan yang lebih baik. Untuk dokumen bisnis kolaboratif atau konten dengan persyaratan pemformatan kompleks, editor rich text seringkali lebih praktis.

Kesalahan Markdown yang Umum

• Baris kosong yang hilang — sebagian besar elemen blok (heading, daftar, blok kode) memerlukan baris kosong sebelum dan sesudahnya untuk dirender dengan benar
• Spasi setelah tanda pagar — ##Heading tanpa spasi setelah tanda pagar bukan heading di sebagian besar prosesor
• Penanda daftar yang tidak konsisten — mencampur - dan * dalam daftar yang sama dapat menghasilkan hasil yang tidak terduga di beberapa prosesor
• Lupa escape karakter khusus — asterisk, garis bawah, dan backtick di dalam teks memerlukan escape backslash jika harus dirender secara literal
• Mengasumsikan sintaksis yang diperluas bersifat universal — tabel dan daftar tugas adalah fitur GFM yang tidak didukung semua prosesor; periksa lingkungan targetmu

BrowseryTools Markdown Editor menyediakan pratinjau langsung sehingga kamu dapat menemukan masalah rendering segera saat menulis, tanpa menyalin teks ke alat lain. Tempel Markdown-mu dan lihat output HTML yang dirender berdampingan.