Menulis Dokumen dengan Markdown dan Mengubahnya Menjadi PDF

# Judul dokumen
## Bagian
### Subbagian

**teks tebal**
*teks miring* atau _teks miring_

- butir pertama
- butir kedua
  - butir bertingkat (indentasi dua spasi)

1. langkah satu
2. langkah dua

- [x] selesai
- [ ] belum dikerjakan

[teks tautan](https://contoh.com)

> Kutipan atau catatan yang ingin ditonjolkan.

| Tugas    | PIC  | Tenggat |
|----------|------|---------|
| Anggaran | Ani  | 12 Mei  |
| Slide    | Budi | 14 Mei  |

Contoh dokumen

Berikut laporan mingguan singkat dalam Markdown:

# Peluncuran ulang situs: laporan mingguan

**Minggu 14 Oktober** · Disusun oleh tim web

## Selesai minggu ini

- Desain halaman beranda baru rampung
- 40 dari 60 halaman produk sudah dipindahkan
- Bug checkout di Safari HP sudah diperbaiki

## Minggu depan

1. Pindahkan 20 halaman produk yang tersisa
2. Mulai uji aksesibilitas
3. Siapkan email peluncuran

## Risiko

> Perubahan API penyedia pembayaran berlaku 1 November.
> Kita butuh akses lingkungan uji mereka paling lambat 25 Oktober.

| Tugas | PIC | Status |
|------|-------|--------|
| Halaman produk | Ani | 67% |
| Aksesibilitas | Budi | Belum mulai |
| Email peluncuran | Citra | Draf |

Tanpa dikonversi pun, teks ini enak dibaca. Setelah diubah ke PDF, ia menjadi laporan dua halaman yang rapi dengan judul, bagian, daftar, risiko yang ditonjolkan, dan tabel.

Mengubah Markdown menjadi PDF

Markdown ke PDF mengonversi Markdown di browser Anda:

1. Buka tool. Ketik atau tempel Markdown di editor, atau klik Buka file .md untuk memuat file dari komputer.
2. Atur nama file, ukuran halaman (A4 atau US Letter), ukuran huruf, dan margin.
3. Klik Buat PDF lalu unduh.

Hasilnya PDF berteks sungguhan: judul, paragraf, daftar, kutipan, blok kode, dan tabel disusun sebagai teks, sehingga orang bisa mencari dan menyalin isinya. Ukuran filenya kecil, biasanya di bawah 50 KB untuk dokumen sepuluh halaman. Blok kode dan tabel yang panjang otomatis berlanjut ke halaman berikutnya.

Pengaturan yang berpengaruh

• Ukuran huruf: 11 poin cocok untuk kebanyakan dokumen. Pakai 10 atau 10,5 untuk materi teknis yang padat, 12 untuk dokumen yang akan dibaca di kertas.
• Margin: sekitar 20 mm (56 poin) adalah standar. Lebih kecil untuk lembar rujukan, lebih besar untuk dokumen yang akan dicoret-coret dengan tangan.
• Ukuran halaman: A4 untuk Indonesia dan sebagian besar dunia, Letter untuk Amerika Utara.

Yang tidak ikut terkonversi

• Gambar: browser tidak bisa mengambil gambar dari internet ke dalam PDF, jadi gambar muncul sebagai teks alternatifnya di dalam kurung. Jika butuh gambar, buat halaman gambar dengan JPG ke PDF lalu gabungkan dengan Gabungkan PDF.
• HTML mentah di dalam Markdown dilewati.
• Karakter non-Latin: PDF memakai font standar Helvetica dan Courier yang tersedia di setiap pembaca PDF. Font ini mencakup bahasa Eropa Barat dan bahasa Indonesia, termasuk huruf beraksen. Emoji, aksara Arab, Mandarin, dan Kiril tercetak sebagai tanda tanya.

Sentuhan akhir

PDF hasil konversi sering butuh sedikit tambahan sebelum dibagikan:

• Nomor halaman: tambahkan dengan Tambah Nomor Halaman, terutama untuk dokumen lebih dari tiga halaman.
• Label draf: bubuhkan "DRAFT" dengan Watermark PDF selama dokumen masih ditinjau.
• Lampiran sebagai halaman: gabungkan PDF pendukung (kontrak, ekspor grafik) dengan Gabungkan PDF.

Alur kerja Markdown yang terbukti berguna

Notulen rapat

Catat rapat langsung dalam Markdown: satu judul per agenda, butir untuk pembahasan, dan daftar tugas untuk tindak lanjut. Setelah rapat, ubah ke PDF dan kirim lewat email atau grup WhatsApp kantor. Daftar tugas berubah menjadi kotak centang yang jelas di PDF, dan notulen bisa dicari di kemudian hari.

Catatan kuliah

Banyak mahasiswa memakai Markdown di Obsidian atau editor biasa untuk membuat catatan yang saling terhubung. Menjelang ujian, ekspor satu topik ke PDF dan cetak. Judul membuat struktur terlihat jelas di kertas.

Dokumentasi teknis

README dan panduan teknis biasanya sudah dalam Markdown. Saat klien atau rekan nonteknis butuh salinannya, ubah ke PDF alih-alih mengirim tautan ke repositori kode.

Laporan dan proposal

Tulis draf dalam Markdown agar fokus pada isi, lalu konversi. Jika versi final butuh kop surat perusahaan, tempel Markdown ke templat pengolah kata (banyak yang menerima Markdown saat ditempel) atau pakai tool seperti Pandoc dengan dokumen rujukan.

Tulisan pribadi

Jurnal, daftar belanja, resep, dan rencana perjalanan: file teks biasa bertahan selamanya dan tidak mengikat Anda ke satu aplikasi.

Sejarah singkat Markdown

Markdown dibuat oleh John Gruber bersama Aaron Swartz pada 2004. Tujuannya sederhana: format yang tetap enak dibaca sebagai teks biasa dan bisa diubah menjadi HTML untuk situs web. Tanda-tandanya meniru kebiasaan orang menulis email teks biasa, seperti bintang untuk penekanan dan tanda hubung untuk daftar.

Karena spesifikasi aslinya longgar, banyak variasi muncul. Pada 2014 proyek CommonMark membuat spesifikasi yang ketat, dan GitHub menambahkan tabel, daftar tugas, dan coretan dalam "GitHub Flavored Markdown". Kini hampir semua tool modern mengikuti salah satu dari keduanya, jadi Markdown yang Anda tulis di satu tempat biasanya tampil sama di tempat lain.

Markdown dibanding pengolah kata

	Markdown	Pengolah kata
Kecepatan menulis	Tinggi	Sedang
Kendali tata letak	Rendah	Tinggi
Ukuran file	Sangat kecil	Sedang sampai besar
Dibuka di aplikasi apa pun	Ya	Butuh aplikasi yang cocok
Kolaborasi dengan komentar	Terbatas	Sangat baik
Cocok untuk	Catatan, laporan, dokumentasi	Surat resmi, dokumen bertata letak

Banyak orang memakai keduanya: Markdown untuk menulis dan berpikir, pengolah kata atau PDF untuk versi resmi yang dikirim keluar.

Tips menulis agar dokumen Markdown lebih baik

• Mulai dengan kerangka judul. Tulis semua judul ## lebih dulu, lalu isi satu per satu. Struktur yang jelas membuat dokumen mudah dipindai.
• Buat paragraf pendek. Tiga sampai lima kalimat. Di layar, paragraf panjang terasa berat.
• Pakai daftar untuk langkah dan pilihan, paragraf untuk penjelasan.
• Tebalkan dengan hemat. Jika semuanya tebal, tidak ada yang menonjol.
• Tulis judul yang informatif. "Anggaran naik 12 persen" lebih berguna dari "Anggaran".
• Taruh kesimpulan di awal. Pembaca yang sibuk sering hanya membaca bagian pertama. Tulis keputusan atau permintaan Anda di paragraf pembuka, lalu jelaskan detailnya di bawah.
• Baca ulang sebagai PDF. Kesalahan struktur, seperti daftar yang menyatu dengan paragraf, lebih mudah terlihat di hasil akhir daripada di teks mentah.

Editor untuk menulis Markdown

Anda bisa menulis Markdown di Notepad sekalipun, tapi editor khusus membuatnya lebih nyaman:

• Obsidian: gratis, untuk catatan pribadi yang saling terhubung, file tersimpan di komputer Anda.
• Visual Studio Code: gratis, populer di kalangan programmer, dengan pratinjau Markdown bawaan.
• Typora: berbayar, menampilkan format secara langsung saat mengetik.
• Aplikasi HP: Markor di Android dan iA Writer di iPhone.
• Editor di tool Markdown ke PDF sendiri: cukup untuk dokumen sekali pakai.

Lebih jauh: Pandoc

Jika butuh kendali lebih, Pandoc adalah konverter gratis berbasis baris perintah yang mengubah Markdown menjadi PDF (lewat LaTeX), Word, EPUB, HTML, dan puluhan format lain. Pandoc mendukung catatan kaki, sitasi, daftar isi, dan templat khusus. Pemasangannya butuh sedikit usaha, tapi untuk dokumen panjang seperti skripsi, tesis, atau buku, Pandoc adalah alat standar. Banyak mahasiswa menulis skripsi dalam Markdown lalu memakai Pandoc dengan templat format kampus mereka.

Konverter di browser adalah jalur cepat untuk dokumen sehari-hari; Pandoc adalah alat berat saat Anda butuh format akademik atau gaya khusus.

Contoh: notulen rapat mingguan

Seorang ketua tim memimpin rapat mingguan 30 menit dengan enam orang. Dulu, notulen ditulis di templat Word yang butuh sepuluh menit untuk dirapikan. Sekarang rutinitasnya:

1. Sebelum rapat, salin file Markdown minggu lalu dan ganti namanya dengan tanggal hari ini.
2. Selama rapat, ketik di bawah setiap judul agenda: butir untuk pembahasan, - [ ] untuk tindak lanjut dengan nama PIC ditebalkan.
3. Setelah rapat, centang tindak lanjut minggu lalu yang sudah selesai, tempel file ke Markdown ke PDF, tambahkan nomor halaman jika lebih dari satu halaman, lalu kirim PDF-nya.

Merapikan sekarang hanya dua menit. Karena notulen setiap minggu adalah file teks bertanggal, mencari "kapan kita memutuskan berhenti dengan pemasok lama?" cukup dengan satu pencarian di folder. Dan siapa pun yang lebih suka membaca dari email atau HP menerima PDF rapi dengan kotak centang yang bisa dipindai dalam hitungan detik.

Menulis Markdown di HP

Markdown sangat cocok untuk HP karena tidak butuh toolbar. Anda bisa mencatat ide di kereta atau ojek, menyusun kerangka laporan di sela rapat, atau menulis notulen langsung di HP saat laptop tidak dibawa. Pakai aplikasi catatan yang menyimpan teks biasa, seperti Markor di Android atau iA Writer dan aplikasi Notes di iPhone. Saat sampai di kantor, salin teksnya ke komputer atau buka langsung Markdown ke PDF di browser HP, tempel, lalu buat PDF dari sana.

Satu kebiasaan kecil yang membantu: aktifkan keyboard dengan baris angka dan simbol, karena Anda akan sering mengetik #, -, dan *. Di keyboard bawaan Android dan iPhone, tekan lama huruf tertentu untuk mendapatkan simbol tanpa berpindah tata letak.

Dari catatan menjadi dokumen resmi

Markdown bagus untuk draf, tapi kantor dan kampus sering meminta dokumen resmi dengan kop surat, nomor surat, atau format tertentu. Anda tidak perlu memilih salah satu. Tulis isi dalam Markdown sampai substansinya matang dan disetujui. Setelah itu ada dua jalan:

• Cukup PDF: jika dokumen hanya untuk dibaca, ubah langsung dengan Markdown ke PDF, tambahkan nomor halaman, dan kirim.
• Butuh format resmi: tempel teks Markdown ke templat Word atau Google Docs kantor. Judul, daftar, dan tabel sudah tersusun, sehingga Anda tinggal menerapkan gaya templat. Pekerjaan merapikan tinggal sedikit karena struktur sudah benar sejak awal.

Dengan cara ini, waktu Anda habis untuk berpikir dan menulis, bukan untuk mengatur spasi dan penomoran.

Kesalahan yang umum

• Tidak ada baris kosong sebelum daftar atau tabel. Daftar menyatu dengan paragraf sebelumnya. Selalu sisakan satu baris kosong.
• Tidak ada spasi setelah #. #Judul bukan judul di kebanyakan tool; # Judul adalah judul.
• Indentasi daftar yang tidak konsisten. Daftar bertingkat butuh dua (kadang empat) spasi. Pilih satu dan pakai terus.
• Tabel tanpa baris pemisah. Baris |---|---| wajib ada.
• Tanda kutip melengkung dan tanda pisah dari Word terlihat normal tapi bisa membingungkan sebagian tool. Di Markdown ke PDF keduanya tidak bermasalah.

Pertanyaan yang sering muncul

Apakah Markdown sama di semua tempat? Hampir. Sintaks intinya universal. "GitHub Flavored Markdown" menambahkan tabel, daftar tugas, dan coretan, yang didukung sebagian besar tool modern.

Bisakah Markdown diubah ke Word? Bisa, dengan Pandoc, atau dengan menempelnya ke aplikasi seperti Google Docs (aktifkan dukungan Markdown di Alat, Preferensi) atau Word dengan add-in.

Bisakah menambahkan catatan kaki? Sebagian variasi mendukung catatan kaki dengan [^1]. Konverter sederhana mungkin mencetaknya sebagai teks biasa; Pandoc menanganinya dengan lengkap.

Apakah teks saya diunggah saat dikonversi? Tidak dengan konverter NewKitApp. PDF dibuat di browser Anda.

Kenapa sebagian karakter menjadi tanda tanya? Font PDF standar hanya mencakup aksara Latin. Untuk aksara lain, pakai Pandoc dengan font yang mendukungnya.

Berbagi Markdown tanpa dikonversi

Kadang PDF tidak diperlukan. GitHub, GitLab, Notion, Slack, Discord, dan banyak forum menampilkan Markdown secara langsung, jadi Anda cukup menempel teks dan formatnya muncul. WhatsApp punya format sendiri yang mirip: *tebal*, _miring_, dan ~coret~. Kebanyakan aplikasi email tidak menampilkan Markdown, jadi untuk email ubah ke PDF atau tempel ke editor teks kaya lebih dulu.

Penutup

Markdown memungkinkan Anda menulis dokumen terstruktur dengan cepat dalam teks biasa: # untuk judul, tanda hubung untuk daftar, bintang untuk penekanan, garis tegak untuk tabel. Formatnya portabel, awet, dan mudah dikonversi. Saat perlu berbagi dengan orang di luar dunia Markdown, ubah ke PDF, tambahkan nomor halaman atau watermark draf bila perlu, dan kirim dokumen yang terlihat selesai dan bisa dibuka di mana saja. Pelajari sepuluh sintaks di atas, tulis notulen rapat berikutnya dalam Markdown, dan kemungkinan besar Anda akan terus memakainya.