Panduan Sintaksis Markdown: Dari Dasar hingga Lanjutan
Markdown adalah format penulisan yang benar-benar disukai oleh para pengembang. Tidak perlu mengklik menu pemformatan, tidak perlu berjuang dengan editor WYSIWYG — cukup teks biasa dengan beberapa simbol yang dikonversi menjadi HTML yang bersih. File README, dokumentasi, posting blog, pesan chat, dan bahkan artikel ini ditulis dalam Markdown.
Pratinjau Markdown Anda secara real-time dengan Markdown Previewer kami — tulis di satu sisi, lihat output yang diformat di sisi lainnya.
Sintaksis Dasar
Heading
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
Gunakan heading secara hierarkis. Jangan melewati level (melompat dari H1 ke H3) — ini merugikan baik keterbacaan maupun aksesibilitas.
Penekanan
*italic* or _italic_
**bold** or __bold__
***bold italic***
~~strikethrough~~
Tautan dan Gambar
[Link text](https://example.com)
[Link with title](https://example.com "Title")
Daftar
- Unordered item
- Another item
- Nested item
1. First item
2. Second item
3. Third item
Kutipan Blok
> This is a blockquote.
> It can span multiple lines.
Kode
Kode Inline
Gunakan backtick untuk kode inline: `const x = 42`
Blok Kode
Tiga backtick dengan pengenal bahasa opsional:
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
Bahasa yang didukung termasuk javascript, python, json, yaml, html, css, bash, dan banyak lagi.
Tabel
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1 | Cell 2 | Cell 3 |
| Cell 4 | Cell 5 | Cell 6 |
Perataan:
| Left | Center | Right |
|:-----|:------:|------:|
| L | C | R |
Sintaksis Lanjutan
Daftar Tugas
- [x] Completed task
- [ ] Pending task
- [ ] Another task
Catatan Kaki
Here is a statement[^1].
[^1]: This is the footnote content.
Daftar Definisi
Term
: Definition of the term
Garis Horizontal
---
***
___
GitHub-Flavored Markdown (GFM)
GitHub memperluas Markdown standar dengan fitur-fitur berguna:
- URL Otomatis Tertaut — URL langsung menjadi dapat diklik
- Daftar tugas — Kotak centang di issues dan PR
- Tabel — Sintaksis pipa yang ditunjukkan di atas
- Coretan —
~~deleted text~~ - Penyorotan sintaksis — Pewarnaan kode khusus bahasa
- Emoji —
:smile:menjadi wajah tersenyum
Tips Menulis
- Jaga paragraf tetap pendek — maksimal 3-5 kalimat
- Gunakan heading untuk membuat struktur yang mudah dipindai
- Lebih baik gunakan daftar daripada paragraf panjang untuk langkah atau fitur
- Tambahkan contoh kode setiap kali membahas konsep teknis
- Pratinjau secara teratur — Markdown Previewer kami menampilkan output saat Anda mengetik
Pertanyaan yang Sering Diajukan
Apa perbedaan antara Markdown dan HTML?
Markdown adalah format penulisan sederhana yang dikonversi ke HTML. Ini mencakup kebutuhan pemformatan paling umum dengan sintaksis yang jauh lebih sedikit. Anda dapat menyisipkan HTML mentah di Markdown ketika Anda membutuhkan fitur yang tidak didukung Markdown.
Varian Markdown mana yang harus saya gunakan?
GitHub-Flavored Markdown (GFM) adalah yang paling banyak didukung. Ini menambahkan tabel, daftar tugas, dan coretan ke Markdown standar. CommonMark adalah spesifikasi yang terstandarisasi.
Bisakah saya menggunakan Markdown untuk dokumentasi?
Tentu saja. Markdown adalah standar untuk file README, wiki, dan situs dokumentasi. Alat seperti MkDocs, Docusaurus, dan GitBook semuanya menggunakan Markdown.
Sumber Terkait
- Markdown vs Teks Kaya — mengapa pengembang lebih memilih teks biasa
- Text Diff Checker — bandingkan file Markdown
- Markdown Previewer — pratinjau Markdown secara real-time
- Text Diff Checker Tool — bandingkan file teks dan Markdown