Markdown Dijelaskan dalam 5 Menit

Anda mungkin sudah pernah menggunakan Markdown tanpa menyadarinya. Pernah mengetik **tebal** dalam pesan Slack? Menulis README di GitHub? Memformat postingan Reddit? Itu adalah Markdown.

Markdown adalah cara ringan untuk memformat teks biasa menggunakan simbol sederhana. Alih-alih mengklik tombol toolbar untuk tebal, miring, judul, dan daftar, Anda mengetik beberapa karakter yang menunjukkan format yang Anda inginkan. Markdown dibuat pada tahun 2004 oleh John Gruber dan Aaron Swartz, dan sejak saat itu menjadi bahasa format default bagi pengembang, penulis, dan siapa pun yang bekerja dengan teks di web.

Mengapa Markdown Ada

Sebelum Markdown, memformat teks untuk web berarti menulis HTML. Untuk membuat kata menjadi tebal, Anda mengetik <strong>tebal</strong>. Untuk membuat daftar, Anda memerlukan <ul><li>item</li></ul>. HTML memang powerful tetapi verbose dan sulit dibaca dalam bentuk mentahnya.

Markdown memecahkan masalah ini dengan menyediakan singkatan yang dapat dibaca manusia. Teks mentah mudah dibaca bahkan sebelum dirender. Output yang diformat bersih dan profesional. Anda mendapatkan yang terbaik dari kedua dunia: teks sumber yang dapat dibaca dan output yang dipoles.

Sintaks Esensial

Berikut semua yang perlu Anda ketahui untuk mulai menggunakan Markdown secara produktif.

Judul

Gunakan simbol tagar (#) untuk membuat judul. Lebih banyak tagar berarti judul lebih kecil.

# Judul 1 (terbesar)
## Judul 2
### Judul 3
#### Judul 4

Tebal dan Miring

Bungkus teks dengan tanda bintang atau garis bawah:

**teks tebal**
*teks miring*
***tebal dan miring***

Daftar

Daftar tidak berurutan menggunakan tanda pisah, tanda bintang, atau tanda plus. Daftar berurutan menggunakan angka.

- Item pertama
- Item kedua
- Item ketiga

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

Tautan

Kurung siku untuk teks, tanda kurung untuk URL:

[Klik di sini](https://example.com)

Gambar

Seperti tautan, tetapi dengan tanda seru di depan:

![Teks alternatif](url-gambar.jpg)

Kutipan Blok

Gunakan simbol lebih besar dari:

> Ini adalah kutipan. Akan diindentasi dan diberi gaya yang berbeda.

Kode

Backtick untuk kode inline, tiga backtick untuk blok kode:

Gunakan fungsi `print()` untuk menampilkan teks.

Untuk blok kode multi-baris, gunakan tiga backtick dengan pengenal bahasa opsional:

```python
def halo():
    print("Halo, dunia!")
```

Garis Horizontal

Tiga atau lebih tanda pisah, tanda bintang, atau garis bawah:

---

Tabel

Gunakan pipa dan tanda pisah:

| Nama | Peran | Lokasi |
| --- | --- | --- |
| Budi | Pengembang | Jakarta |
| Siti | Desainer | Surabaya |

Di Mana Markdown Digunakan

Markdown ada di mana-mana:

Pengembangan Software

• GitHub, GitLab, Bitbucket: README, issues, pull request, dan dokumentasi semuanya ditulis dalam Markdown.
• Stack Overflow: Pertanyaan dan jawaban menggunakan format Markdown.
• Dokumentasi kode: Banyak generator dokumentasi (Docusaurus, MkDocs, Jekyll) menggunakan Markdown sebagai format sumbernya.

Komunikasi

• Slack: Mendukung subset Markdown untuk format pesan.
• Discord: Menggunakan Markdown untuk tebal, miring, blok kode, dan lainnya.
• Reddit: Postingan dan komentar diformat dengan Markdown.

Penulisan dan Penerbitan

• Blog: Banyak generator situs statis menggunakan file Markdown sebagai sumber konten.
• Buku: Beberapa alat penerbitan menerima manuskrip Markdown.
• Catatan: Aplikasi seperti Obsidian, Notion, Bear, dan Typora dibangun di sekitar Markdown.

Dokumentasi

• Dokumen teknis: Dokumentasi API, panduan pengguna, dan wiki umumnya menggunakan Markdown.
• Basis pengetahuan internal: Banyak tim menggunakan wiki berbasis Markdown.

Varian Markdown

Satu hal yang perlu diketahui: ada berbagai "varian" Markdown. Sintaks inti sama di mana-mana, tetapi beberapa platform menambahkan ekstensi:

Perbedaannya sebagian besar ada di fitur-fitur lanjutan. Dasar-dasarnya (judul, tebal, miring, daftar, tautan, gambar, kode) bekerja sama di mana-mana.

Kesalahan Umum

Lupa Baris Kosong

Markdown memerlukan baris kosong sebelum dan sesudah banyak elemen. Judul memerlukan baris kosong sebelumnya. Daftar memerlukan baris kosong sebelum dan sesudahnya. Melupakan baris kosong ini adalah sumber masalah rendering yang paling umum.

Penanda Daftar yang Tidak Konsisten

Mencampur -, *, dan + dalam daftar yang sama dapat menyebabkan rendering yang tidak terduga. Pilih satu dan tetap gunakan itu.

Spasi Setelah Simbol

Beberapa prosesor Markdown memerlukan spasi setelah # dalam judul dan setelah - dalam daftar. Selalu sertakan spasi untuk aman.

# Judul yang benar
#Judul yang salah

- Item daftar yang benar
-Item daftar yang salah

Mengapa Markdown Layak Dipelajari

Markdown membutuhkan waktu lima menit untuk dipelajari dan menghemat berjam-jam seiring waktu. Setelah Anda mengetahuinya, Anda dapat:

• Menulis dokumentasi yang dirender dengan indah di GitHub
• Memformat pesan di Slack dan Discord tanpa menyentuh mouse
• Membuat catatan terstruktur yang dapat dipindahkan antar aplikasi
• Membuat postingan blog dan konten web dari file teks biasa
• Berkolaborasi dalam dokumen berbasis teks tanpa masalah kompatibilitas format

Rasio investasi-terhadap-hasil adalah salah satu yang terbaik di seluruh dunia teknologi.

Mulai menulis dalam Markdown sekarang:

• Tulis dan Pratinjau Markdown
• Alat Pratinjau Markdown

Gratis, di browser Anda, dengan pratinjau real time saat Anda mengetik.