Sintaks Markdown Dasar untuk Menulis Berita dan Artikel

Pernahkah Bapak/Ibu bertanya-tanya bagaimana tulisan di situs ini bisa punya judul, huruf tebal, daftar bernomor, sampai tabel yang rapi? Rahasianya ada pada Markdown.

Markdown adalah cara menulis yang memakai tanda-tanda sederhana, seperti pagar # atau bintang *, untuk memberi format pada teks. Saat naskahnya masih berupa teks biasa pun, tulisan tetap enak dibaca. Begitu situs diperbarui, tanda-tanda itu otomatis berubah menjadi tampilan halaman web yang rapi.

Kenapa Markdown? Ada beberapa alasan yang membuatnya disukai banyak penulis:

• Mudah dipelajari. Tandanya hanya sedikit dan cepat diingat.
• Tidak gampang salah. Tidak perlu repot membuka dan menutup tag seperti di HTML.
• Hasilnya rapi. Halaman yang dihasilkan sesuai standar web.
• Fokus pada isi. Urusan tampilan sudah diatur situs, jadi penulis cukup memikirkan apa yang ingin disampaikan.

Tulisan ini merangkum tanda-tanda dasar yang paling sering dipakai. Sumbernya adalah artikel Basic Markdown Syntax di blog Aan Triono, yang juga diadaptasi dari dokumentasi Grav. Tidak perlu dihafal sekaligus. Cukup baca sekilas, lalu buka lagi halaman ini kapan pun dibutuhkan.

Judul (heading)

Untuk membuat judul, cukup tulis tanda pagar # di awal baris. Makin banyak pagarnya, makin kecil tingkat judulnya, dari tingkat 1 sampai tingkat 6.

# Judul tingkat 1
## Judul tingkat 2
### Judul tingkat 3
#### Judul tingkat 4
##### Judul tingkat 5
###### Judul tingkat 6

Satu hal yang perlu diingat: di situs ini, judul utama tulisan sudah diambil dari bagian title. Jadi, subjudul di dalam tulisan sebaiknya dimulai dari ##. Bonusnya, setiap subjudul ## dan ### akan otomatis muncul di daftar isi di samping tulisan.

Komentar

Kadang kita perlu meninggalkan catatan kecil di naskah, misalnya “foto menyusul” atau “cek lagi nama pemateri”. Untuk itu, gunakan komentar. Isinya tidak akan tampil di halaman, jadi aman untuk catatan pribadi.

<!-- Catatan ini tidak akan terlihat oleh pembaca -->

Garis pemisah

Ingin memberi jeda antarbagian? Tulis tiga tanda strip, tiga garis bawah, atau tiga bintang di satu baris tersendiri.

---
___
***

Tampilannya seperti ini:

Paragraf

Menulis paragraf sama seperti mengetik biasa. Yang perlu diperhatikan hanya satu: untuk memulai paragraf baru, beri satu baris kosong di antara keduanya.

Ini paragraf pertama.

Ini paragraf kedua.

Penekanan teks

Tebal

Untuk menebalkan kata penting, apit dengan dua bintang atau dua garis bawah.

**Teks ini tebal**
__Teks ini juga tebal__

Hasilnya: Teks ini tebal

Miring

Untuk huruf miring, misalnya pada istilah asing, cukup pakai satu bintang atau satu garis bawah.

*Teks ini miring*
_Teks ini juga miring_

Hasilnya: Teks ini miring

Coret

Teks yang dicoret cocok untuk menunjukkan ralat. Apit teksnya dengan dua tanda tilde (~).

~~Teks ini dicoret~~

Hasilnya: Teks ini dicoret

Gabungan

Tanda-tanda tadi juga bisa dipadukan, misalnya tebal sekaligus miring.

***Tebal dan miring***
**Tebal dengan _bagian miring_ di dalamnya**

Hasilnya: Tebal dan miring, dan tebal dengan bagian miring di dalamnya.

Kutipan (blockquote)

Saat mengutip pendapat narasumber atau kata sambutan, awali barisnya dengan tanda >. Kutipan juga bisa dibuat bertingkat dengan menambah tanda >.

> Belajar matematika adalah belajar bernalar.
>
>> Kutipan di dalam kutipan.

Tampilannya:

Belajar matematika adalah belajar bernalar.

Kutipan di dalam kutipan.

Daftar

Daftar tidak berurut

Untuk daftar biasa, awali setiap butir dengan -, *, atau +. Kalau ingin membuat sub-butir, geser ke dalam dengan dua spasi.

- Bilangan
- Aljabar
  - Persamaan linear
  - Pertidaksamaan linear
- Geometri

Tampilannya:

• Bilangan
• Aljabar
  • Persamaan linear
  • Pertidaksamaan linear
• Geometri

Daftar berurut

Untuk urutan langkah atau susunan acara, tulis angka yang diikuti titik.

1. Pembukaan
2. Paparan materi
3. Kerja kelompok

Tampilannya:

1. Pembukaan
2. Paparan materi
3. Kerja kelompok

Ada trik kecil di sini: semua butir boleh ditulis 1. saja. Markdown akan menomorinya sendiri. Jadi, kalau suatu saat ada butir yang disisipkan di tengah, Bapak/Ibu tidak perlu membetulkan nomornya satu per satu.

Daftar tugas

Daftar tugas cocok untuk menunjukkan apa saja yang sudah dan belum dikerjakan. Gunakan - [ ] untuk tugas yang belum selesai dan - [x] untuk yang sudah selesai.

- [x] Menyusun ATP
- [ ] Menyusun modul ajar
- [ ] Mengunggah ke Perangkat Ajar

Tampilannya:

• Menyusun ATP
• Menyusun modul ajar
• Mengunggah ke Perangkat Ajar

Kode

Bagian ini terutama berguna bagi Bapak/Ibu yang sering berbagi rumus lembar kerja atau potongan program.

Kode sebaris

Untuk menyisipkan kode di tengah kalimat, apit dengan satu tanda backtick (`). Tanda ini biasanya ada di kiri atas papan ketik, di bawah tombol Esc.

Gunakan fungsi `SUM()` di lembar kerja.

Hasilnya: Gunakan fungsi SUM() di lembar kerja.

Blok kode

Kalau kodenya lebih dari satu baris, ada dua cara. Cara pertama, geser setiap baris kode ke dalam dengan empat spasi:

    baris kode 1
    baris kode 2

Cara kedua lebih disarankan, yaitu mengapit kode dengan tiga backtick di awal dan di akhir. Tuliskan juga nama bahasanya setelah backtick pembuka, supaya kodenya diberi warna dan lebih mudah dibaca.

```python
def luas_persegi(sisi):
    return sisi * sisi
```

Tampilannya:

def luas_persegi(sisi):
    return sisi * sisi

Tabel

Tabel sangat membantu untuk menyajikan data, misalnya pembagian materi per kelas. Pisahkan setiap kolom dengan garis tegak |, lalu beri baris tanda strip di bawah judul kolom.

Posisi teks di kolom bisa diatur dengan titik dua pada baris tanda strip: :--- untuk rata kiri, :---: untuk rata tengah, dan ---: untuk rata kanan.

| Kelas | Materi             | Jumlah JP |
| :---- | :----------------: | --------: |
| VII   | Bilangan bulat     | 12        |
| VIII  | Teorema Pythagoras | 10        |
| IX    | Transformasi       | 8         |

Tampilannya:

Tidak perlu repot meluruskan garis tegaknya. Selama jumlah kolomnya sama, tabel tetap tampil rapi.

Tautan

Untuk membuat tautan, tulis teksnya di dalam kurung siku, lalu alamatnya di dalam kurung biasa tepat setelahnya. Bila ingin menambahkan keterangan yang muncul saat kursor diarahkan ke tautan, tulis keterangan itu di dalam tanda kutip.

[Halaman Perangkat Ajar](/perangkat-ajar)
[Blog Aan Triono](https://www.aantriono.com "Kunjungi blog")
<https://www.aantriono.com>

Hasilnya: Halaman Perangkat Ajar, Blog Aan Triono, dan https://www.aantriono.com.

Cara terakhir paling praktis: cukup apit alamatnya dengan kurung sudut, dan alamat itu langsung menjadi tautan.

Catatan kaki

Catatan kaki berguna untuk menyebutkan sumber atau penjelasan tambahan tanpa mengganggu alur tulisan. Beri tanda [^1] pada teks, lalu tulis isi catatannya di bagian lain, biasanya di akhir tulisan.

Markdown diperkenalkan pada tahun 2004.[^1]

[^1]: Dibuat oleh John Gruber bersama Aaron Swartz.

Hasilnya: Markdown diperkenalkan pada tahun 2004.¹ Coba klik angka kecil itu, Bapak/Ibu akan dibawa ke catatannya di bagian bawah halaman.

Sebaiknya catatan kaki tidak diletakkan di dalam daftar atau tabel, karena bisa tidak tampil dengan benar.

Gambar

Menyisipkan gambar mirip dengan membuat tautan, hanya saja diawali tanda seru !. Teks di dalam kurung siku adalah keterangan gambar. Keterangan ini penting, karena akan dibacakan oleh aplikasi pembaca layar dan muncul bila gambar gagal dimuat.

![Suasana pertemuan rutin](/assets/image/berita/pertemuan-rutin-2026-10-27.jpg)

Tampilannya:

HTML di dalam Markdown

Sesekali mungkin ada kebutuhan yang tidak bisa dipenuhi Markdown. Jangan khawatir, tag HTML boleh langsung ditulis di dalam naskah, misalnya untuk menggambarkan tombol papan ketik.

Tekan tombol <kbd>Ctrl</kbd> + <kbd>S</kbd> untuk menyimpan.

Hasilnya: Tekan tombol Ctrl + S untuk menyimpan.

Penutup

Ternyata tidak sesulit yang dibayangkan, bukan? Dengan beberapa tanda sederhana tadi, Bapak/Ibu sudah bisa menulis laporan kegiatan, pengumuman, maupun artikel yang rapi.

Tidak perlu langsung sempurna. Mulailah dari yang paling sering dipakai, yaitu subjudul, huruf tebal, dan daftar. Sisanya akan terbiasa dengan sendirinya. Simpan halaman ini sebagai contekan, dan jangan ragu mengirimkan tulisan Bapak/Ibu kepada pengurus untuk dimuat di menu Berita. Kami tunggu karya-karyanya!