Panduan Lengkap Markdown untuk Guru: Sintaks Dasar dari A sampai Z

Markdown dipakai di berbagai tempat—catatan, forum, GitHub, dan juga editor materi PapanAjar. Kabar baiknya, sintaksnya hanya sekitar sepuluh aturan kecil. Menguasai semuanya cukup sekali duduk. Artikel ini adalah versi bahasa Indonesia dari Basic Syntax Markdown Guide, disesuaikan dengan kebutuhan guru.

1. Judul dan paragraf — kerangka materi

Gunakan tanda # untuk membuat heading. Semakin banyak tanda #, semakin kecil tingkatannya. Selalu beri satu spasi setelah tanda #, dan sisipkan baris kosong di antara paragraf agar hasilnya rapi.

Kamu menulis:

# Judul Bab 1
## Sub-bab 1.1
### Bagian 1.1.1
#### Sub-bagian kecil

• # untuk judul utama materi (gunakan satu saja).
• ## untuk bab, seperti "Tujuan Pembelajaran" atau "Kesimpulan".
• ### untuk sub-bab, seperti "A. Pengertian", "B. Ciri-Ciri".

Untuk ganti baris di tengah paragraf (tanpa paragraf baru), akhiri baris dengan dua spasi lalu Enter:

Kalimat pertama di baris ini.  
Kalimat kedua langsung di bawahnya tanpa baris kosong.

2. Teks tebal, miring, dan kombinasi

Bungkus kata dengan tanda ** (dua bintang) untuk tebal, * (satu bintang) untuk miring, dan tiga bintang untuk keduanya. Selalu pakai bintang (*), bukan underscore, agar konsisten di semua aplikasi:

**Tebal** untuk kata penting.
*Miring* untuk istilah asing.
***Tebal dan miring*** untuk penekanan kuat.

3. Kutipan (blockquote)

Tambahkan tanda > di awal baris untuk membuat kutipan atau kotak pesan penting—cocok untuk motto kelas atau pengingat sebelum belajar:

> "Pendidikan adalah senjata yang paling ampuh
> untuk mengubah dunia."
> — Nelson Mandela

4. Daftar: butir dan bernomor

Gunakan - untuk daftar butir dan angka diikuti titik untuk daftar bernomor (langkah-langkah). Untuk sub-daftar, beri indentasi dua spasi di awal baris:

- Satu ide utama per butir
- Gunakan kepala butir yang padat
  - Sub-poin untuk rincian
  - Cukup satu level dalam saja

1. Langkah pertama
2. Langkah kedua
3. Langkah ketiga

Materi di HP paling enak dibaca sebagai daftar pendek. Pisahkan satu kartu berisi maksimal 5–7 butir, dengan sub-daftar maksimal satu level.

5. Kode: nama file dan blok contoh

Untuk menyebut nama berkas, menu, atau istilah khusus dalam satu baris, bungkus dengan backtick (`):

Untuk menyebut nama berkas, tulis `catatan.md`.
Nama menu seperti `Pengaturan` juga lebih jelas dalam kode.

Untuk menampilkan beberapa baris sekaligus (misal rumus percobaan atau contoh soal), gunakan tiga backtick di awal dan akhir—disebut fenced code block. Tulis nama bahasa setelah backtick pertama agar warnanya rapi:

```markdown
# Contoh blok kode
Biasanya dipakai untuk menampilkan potongan rumus atau kode program.
```

6. Tautan (link)

Format tautan: teks yang terlihat di dalam kurung siku [ ], diikuti URL di dalam kurung biasa ( ). Tanpa spasi di antara keduanya:

Lihat [panduan resmi Markdown](https://www.markdownguide.org).
Hubungi [Guru Matematika](mailto:guru@sekolah.sch.id).

7. Gambar

Sama seperti tautan, tapi diawali tanda seru !. Teks di dalam kurung siku menjadi teks alternatif (alt) yang terbaca saat gambar gagal dimuat atau untuk pembaca layar:

![Diagram fotosintesis](https://papanajar.id/storage/diagram-fotosintesis.png)

Cara menyiapkan dan menyematkan gambar ke materi dijelaskan di Cara Embed Gambar di Materi.

8. Garis pemisah

Tulis tiga tanda hubung --- pada baris sendiri untuk memisahkan bagian besar. Padukan dengan baris kosong di atas dan di bawahnya:

# Bab Pertama

---

# Bab Kedua

9. Bonus yang didukung PapanAjar (GFM)

Editor materi PapanAjar memakai spesifikasi GitHub Flavored Markdown, jadi selain sintaks dasar di atas, kamu juga bisa memakai:

Tabel

Pisahkan kolom dengan tanda | dan beri baris pemisah ---. Sangat berguna untuk data, pertandingan, atau kunci jawaban:

| Elemen | Simbol | Contoh |
|--------|--------|--------|
| Judul | # | # Bab 1 |
| Tebal | ** | **penting** |
| Daftar | - | - butir |

| Kunci Jawaban | Pilihan |
|---------------|---------|
| A | Fotosintesis |
| C | Respirasi |

Daftar tugas dan coretan

- [x] Rangkum bab 2
- [ ] Buat 5 soal latihan
- [x] Terbitkan materi

Teks yang dicoret memakai ~~dua tanda gelombang~~, dan tautan otomatis terbentuk dari URL yang ditulis langsung seperti https://papanajar.id.

10. Karakter khusus

Ingin menampilkan simbol yang dipakai Markdown sebagai teks biasa (misalnya * atau [1])? Beri tanda garis miring \ di depannya:

\* bukan daftar, hanya teks biasa
\[1\] bukan tautan