Langkah Awal

Apakah Markdown?

Markdown adalah bahasa markup ringan yang dapat Anda gunakan untuk menambahkan elemen pemformatan ke dokumen teks biasa. Dibuat oleh John Gruber pada tahun 2004, Markdown sekarang menjadi salah satu bahasa markup paling populer di dunia.

Menggunakan Markdown berbeda dengan menggunakan editor WYSIWYG. Dalam aplikasi seperti Microsoft Word, Anda mengklik tombol untuk memformat tulisan dan tampilan dokumen, dan perubahan langsung terlihat. Markdown tidak seperti itu. Ketika Anda membuat file berformat Markdown, Anda menambahkan sintaks Markdown ke teks untuk menunjukkan tulisan dan bagian dokumen mana yang akan terlihat berbeda.

Misalnya, untuk menunjukkan judul, Anda menambahkan tanda # sebelum teks judul (misalnya, # Sintaks Markdown). Atau, untuk membuat tulisan tebal, Anda menambahkan dua tanda bintang sebelum dan sesudahnya (misalnya, **teks ini tebal**). Mungkin perlu waktu untuk membiasakan diri melihat sintaks Markdown dalam teks Anda, terutama jika Anda terbiasa dengan aplikasi WYSIWYG. Tangkapan layar di bawah ini memperlihatkan file Markdown yang ditampilkan di editor khusus Markdown Typora.

Anda dapat menambahkan elemen pemformatan Markdown ke file teks ASCII menggunakan aplikasi editor teks. Atau, Anda dapat menggunakan salah satu dari banyak aplikasi Markdown untuk sistem operasi macOS, Windows, Linux, iOS, dan Android. Terdapat juga beberapa aplikasi berbasis web yang dirancang khusus untuk menulis file Markdown.

Bergantung pada aplikasi yang Anda gunakan, Anda mungkin tidak dapat mem-pratinjau dokumen yang diformat secara langsung. Hal itu tidak mengapa, karena menurut [Gruber] (https://daringfireball.net/projects/markdown/), sintaks Markdown dirancang agar dapat dibaca dan tidak mengganggu, sehingga teks dalam file asli Markdown tetap dapat dibaca meskipun belum diproses.

Tujuan Markdown adalah membuat dokumen yang memuat sintak untuk memformatnya, namun naskah aslinya tetap terbaca semaksimal mungkin. Ide dasarnya adalah bahwa dokumen Markdown harus dapat diterbitkan dari naskah aslinya apa adanya (tanpa diubah sedikitpun), sebagai teks biasa, tanpa terlihat seperti telah ditamabah dengan tag atau perintah-perintah pemformatan.

Mengapa Menggunakan Markdown?

Anda mungkin bertanya-tanya mengapa orang menggunakan Markdown alih-alih editor WYSIWYG. Mengapa menulis dengan Markdown ketika Anda dapat menekan tombol di antarmuka untuk memformat teks Anda? Ternyata, terdapatbeberapa alasan berbeda mengapa orang menggunakan Markdown alih-alih editor WYSIWYG.

• Markdown dapat digunakan untuk semuanya. Orang menggunakannya untuk membuat situs web, dokumen, catatan, buku, presentasi, pesan email, dan dokumentasi teknis.

• Markdown bersifat portabel. File yang berisi teks berformat Markdown dapat dibuka menggunakan hampir semua aplikasi. Jika Anda memutuskan tidak menyukai aplikasi Markdown yang saat ini Anda gunakan, Anda dapat mengimpor file Markdown ke aplikasi Markdown lain. Itu sangat kontras dengan aplikasi pemrosesan kata seperti Microsoft Word yang mengunci konten Anda ke dalam format file berpemilik.

• Markdown bersifat platform independen. Anda dapat membuat teks berformat Markdown di perangkat apa pun yang menjalankan sistem operasi apa pun.

• Markdown bersifat tak akan lekang ditelan masa. Meskipun aplikasi yang Anda gunakan berhenti berfungsi suatu saat di masa mendatang, Anda masih dapat membaca teks berformat Markdown menggunakan aplikasi pengeditan teks. Ini adalah pertimbangan penting dalam hal buku, tesis universitas, dan dokumen tonggak sejarah lainnya yang perlu dipertahankan tanpa batas waktu.

• Markdown sudah hadir di mana-mana. Situs web seperti Reddit dan GitHub mendukung Markdown, dan banyak aplikasi berbasis desktop (contohnya RStudio) dan web mendukungnya.

Melangkah Lebih Cepat

Cara terbaik untuk memulai dengan Markdown adalah dengan menggunakannya. Hail ini dapat dilakukan dengan lebih mudah dari sebelumnya berkat berbagai alat bantu gratis.

Anda bahkan tidak perlu mengunduh apa pun. Terdapat beberapa editor Markdown online yang dapat Anda gunakan untuk mencoba menulis di Markdown. Dillinger adalah salah satu editor Markdown online terbaik. Cukup buka situs tersebut dan mulailah mengetik di panel kiri. Pratinjau dokumen yang diproses akan muncul di panel kanan.

Anda mungkin ingin tetap membuka situs web Dillinger sambil membaca panduan ini. Dengan demikian Anda dapat mencoba langsung setiap sintaks yang sedang Anda pelajari. Setelah terbiasa dengan Markdown, Anda mungkin ingin menggunakan aplikasi Markdown yang dapat diinstal di komputer desktop atau perangkat seluler Anda.

Bagaimana Cara Kerjanya?

Dillinger membuat penulisan Markdown mudah karena menyembunyikan hal-hal yang terjadi di belakang layar, tetapi ada baiknya juga Anda menjelajahi bagaimana proses bekerja Markdown secara umum.

Ketika Anda menulis Markdown, teks disimpan dalam file teks ASCII yang memiliki ekstensi .md atau .markdown. Selanjutnya bagaimana? Bagaimana file asli Markdown Anda dikonversi menjadi HTML atau dokumen siap cetak?

Jawaban singkatnya adalah Anda memerlukan Aplikasi Markdown yang mampu memproses file Markdown. Terdapat banyak aplikasi yang tersedia - semuanya mulai dari skrip sederhana hingga aplikasi desktop yang terlihat seperti Microsoft Word. Terlepas dari perbedaan visual mereka, semua aplikasi melakukan hal yang sama. Seperti Dillinger, semuanya mengkonversi teks asli Markdown ke HTML sehingga dapat ditampilkan di browser web.

Aplikasi Markdown menggunakan sesuatu yang disebut pengolah Markdown (juga biasa disebut sebagai “parser” atau “implementasi”) untuk mengambil teks asli Markdown dan memprosesnya menjadi format HTML. Pada saat itu, dokumen Anda dapat ditampilkan di browser web atau dikombinasikan dengan skrip pengaturan dokumen dan dicetak. Anda dapat melihat representasi visual dari proses ini di bawah ini.

Untuk meringkas, ini adalah proses empat bagian:

1. Buat file Markdown menggunakan editor teks atau aplikasi Markdown khusus. File harus memiliki ekstensi .md atau .markdown.
2. Buka file Markdown dalam aplikasi Markdown.
3. Gunakan aplikasi Markdown untuk mengkonversi file Markdown ke dokumen HTML.
4. Lihat file HTML di browser web atau gunakan aplikasi Markdown untuk mengonversinya ke format file lain, seperti PDF.

Dari perspektif Anda, prosesnya akan bervariasi agak tergantung pada aplikasi yang Anda gunakan. Misalnya, Dillinger pada dasarnya menggabungkan langkah 1-3 ke dalam satu antarmuka yang mulus — yang harus Anda lakukan adalah mengetik di panel kiri dan setelah diproses secara ajaib muncul di panel kanan. Tetapi jika Anda menggunakan alat bantu lain, seperti editor teks dengan generator situs web statis, Anda akan menemukan bahwa prosesnya jauh lebih terlihat.

Markdown Baik Untuk Apa Saja?

Markdown adalah cara cepat dan mudah untuk membuat catatan, membuat isi situs web, dan menghasilkan dokumen siap cetak.

Tidak butuh waktu lama untuk mempelajari sintaks Markdown, dan begitu Anda tahu cara menggunakannya, Anda dapat menulis dokumen Markdown hampir di mana saja. Kebanyakan orang menggunakan Markdown untuk membuat dokumen web, tetapi Markdown juga sangat cocok untuk memformat semua dokumen mulai dari pesan e-mail hingga daftar belanjaan.

Berikut adalah beberapa contoh apa yang dapat Anda hasilkan dengan dokumen Markdown.

Situs Web

Markdown dirancang untuk web, jadi seharusnya tidak mengherankan bahwa banyak aplikasi yang dirancang khusus untuk membuat konten situs web mendukung Markdown.

Jika Anda mencari cara paling sederhana untuk membuat isi situs web dengan file Markdown, lihat blot.im¹ dan smallvictori.es². Setelah Anda mendaftar ke salah satu layanan ini (menggunakan akun Dropbox), mereka membuat folder di akun Dropbox Anda. Cukup seret dan letakkan file-file Markdown Anda ke dalam folder tersebut dan - blum! - mereka ada di situs web Anda. Tidak ada yang lebih mudah daripada cara ini!

Jika Anda terbiasa dengan HTML, CSS, dan kontrol versi, lihat Jekyll, generator situs statis populer yang mengambil dokumen Markdown dan membangun situs web dengan menghasilkan file-file HTML dari file-file Markdown tersebut. Salah satu keuntungan pendekatan ini adalah bahwa halaman GitHub menyediakan hosting gratis untuk situs web yang dihasilkan Jekyll. Jika Jekyll bukan pilihan favorit Anda, cukup pilih salah satu di antara banyak generator situs statis lainnya yang tersedia.

Jika Anda ingin menggunakan sistem manajemen konten (CMS) untuk memberi kekuatan pada situs web Anda, lihatlah Ghost. Ini adalah platform blogging gratis dan open-source dengan editor Markdown yang bagus. Jika Anda pengguna WordPress, Anda akan senang mengetahui adanya dukungan Markdown untuk situs web yang di-hosting di WordPress.com. Situs WordPress yang di-hosting tersebut juga dapat menggunakan plugin Jetpack.

Dokumen

Markdown tidak memiliki semua lonceng dan peluit pengolah kata seperti Microsoft Word, tetapi cukup baik untuk membuat dokumen dasar seperti tugas dan surat. Anda dapat menggunakan aplikasi penulisan dokumen Markdown untuk membuat dan mengekspor dokumen Markdown ke format file PDF atau HTML. Bagian PDF adalah kunci, karena setelah Anda memiliki dokumen PDF, Anda dapat melakukan apa saja — mencetaknya, mengirimkan lewat email, atau mengunggahnya ke situs web.

Berikut adalah daftar sebagian kecil aplikasi penulisan dokumen Markdown yang dapat Anda pilih (Mintalah bantuan Google untuk menemukan daftar yang lebih panjang aplikasi Markdown.):

• Mac: MacDown, iA Writer, atau Marked
• iOS / Android: iA Writer
• Windows: ghostwriter, Typora atau Markdown Monster
• Linux: ReText atau ghostwriter
• Web: Dillinger atau StackEdit

Catatan

Dalam hampir semua hal, Markdown adalah sintaks yang ideal untuk membuat catatan. Sayangnya, Evernote dan OneNote, dua aplikasi catatan paling populer, saat ini tidak mendukung Markdown. Kabar baiknya adalah bahwa beberapa aplikasi catatan lainnya sudah mendukung Markdown:

• Simplenote adalah aplikasi untuk membuat catatan andalan yang gratis dan tersedia untuk setiap platform.
• Terkenal adalah aplikasi membuat catatan yang dapat berjalan di berbagai platform.
• Bear adalah aplikasi mirip Evernote yang tersedia untuk perangkat Mac dan iOS. Aplikasi ini tidak secara khusus menggunakan dan mengaktifkan Markdown, tetapi Anda dapat mengaktifkan modus kompatibilitas Markdown.
• Boostnote menganggap dirinya sebagai “aplikasi pembuat catatan open source yang dirancang untuk programer.”

Jika Anda tidak dapat berpisah dengan Evernote, lihat Marxico, editor Markdown berbasis langganan untuk Evernote, atau gunakan Markdown Here dengan situs web Evernote.

Buku

Ingin mempublikasikan novel sendiri? Cobalah Leanpub, layanan yang mengambil file berformat Markdown Anda dan mengubahnya menjadi buku elektronik. Leanpub mengeluarkan buku Anda dalam format file PDF, EPUB, dan MOBI. Jika ingin membuat salinan paperback buku, Anda dapat mengunggah file PDF ke layanan lain seperti Kindle Direct Publishing. Untuk mempelajari selengkapnya tentang menulis dan menerbitkan sendiri buku menggunakan Markdown, baca posting blog ini.

Presentasi

Percaya atau tidak, Anda dapat membuat presentasi dari file berformat Markdown. Membuat presentasi di Markdown membutuhkan sedikit membiasakan diri, tetapi begitu Anda sudah terbiasa, akan jauh lebih cepat dan lebih mudah daripada menggunakan aplikasi seperti PowerPoint atau Keynote. Remark (Proyek GitHub) adalah alat tayangan slide Markdown berbasis browser yang populer, seperti halnya Cleaver (Proyek GitHub) dan Marp (proyek GitHub). Jika Anda menggunakan Mac dan lebih suka menggunakan aplikasi, lihat Deckset, Hyperdeck, atau Ditandai.

Email

Jika Anda mengirim banyak email dan bosan dengan kontrol pemformatan yang tersedia di sebagian besar situs web penyedia email, Anda akan senang hati mengetahui cara mudah menulis pesan email menggunakan Markdown. Markdown Here adalah ekstensi browser gratis dan open-source yang mengonversi teks berformat Markdown menjadi HTML yang siap dikirim.

Kolaborasi

Aplikasi kolaborasi dan pesan tim adalah cara populer untuk berkomunikasi dengan rekan kerja dan teman di tempat kerja dan rumah. Aplikasi ini tidak menggunakan semua fitur Markdown, tetapi fitur yang mereka sediakan cukup berguna. Misalnya, kemampuan untuk menebalkan dan mencetak miring teks tanpa menggunakan antarmuka WYSIWYG cukup berguna. Slack, Discord, dan Mattermost adalah semua aplikasi kolaborasi yang baik.

Dokumentasi

Markdown sangat cocok untuk dokumentasi teknis. Perusahaan seperti GitHub semakin beralih ke Markdown untuk dokumentasi mereka - lihat posting blog mereka tentang bagaimana mereka memigrasikan dokumentasi berformat Markdown mereka ke Jekyll. Jika Anda menulis dokumentasi untuk produk atau layanan, lihat alat praktis ini:

• Read the Docs dapat menghasilkan situs web dokumentasi dari file-file Markdown asli Anda. Cukup hubungkan repositori GitHub Anda ke layanan mereka dan dorong ke sana - Baca dokumentasinya untuk panduan selengkapnya. Mereka juga memiliki layanan untuk entitas komersial.
• MkDocs adalah generator situs statis yang cepat dan sederhana yang diarahkan untuk membangun dokumentasi proyek. File sumber dokumentasi ditulis dalam format Markdown dan diatur menggunakan satu file konfigurasi YAML. MkDocs memiliki beberapa tema bawaan, termasuk turunan dari tema dokumentasi Read the Docs untuk digunakan dengan MkDocs. Salah satu tema terbaru adalah MkDocs Material.
• Docusaurus adalah generator situs statis yang dirancang khusus untuk membuat situs web dokumentasi. Ini mendukung terjemahan, pencarian, dan pembuatan versi.
• VuePress adalah generator situs statis yang didukung oleh Vue dan dioptimalkan untuk menulis dokumentasi teknis.
• Jekyll yang disebutkan sebelumnya di bagian di Situs Web, tetapi juga merupakan opsi yang baik untuk membuat situs web dokumentasi dari file Markdown. Jika Anda tertarik menggunakannnya, pastikan untuk memeriksa tema dokumentasi Jekyll.

Cita Rasa Markdown

Salah satu aspek yang paling membingungkan dalam menggunakan Markdown adalah bahwa hampir setiap aplikasi Markdown menerapkan versi Markdown yang sedikit berbeda, meskipun secara umum mereka menggunakan sintaks dasar Markdown yang sama. Varian Markdown ini biasa disebut sebagai cita rasa. Anda perlu mengenal cita rasa Markdown yang diterapkan aplikasi yang Anda gunakan.

Anda dapat menganalogikan konsep cita rasa Markdown ini sebagai dialek dalam bahasa manusia. Orang-orang di suatu wilayah atau negara menggunakan bahasa yang sama, tetapi mungkin terdapat perbedaan dialek antar daerah-daerah tertentu. Hal yang sama berlaku untuk orang yang menggunakan aplikasi Markdown yang berbeda. Menggunakan Dillinger untuk menulis Markdown adalah pengalaman yang sangat berbeda dengan menggunakan Ulysses.

Secara sederhana dapat dikatakan, Anda tidak pernah tahu persis apa maksud pernyataan bahwa suatu aplikasi atau situs mendukung “Markdown.” Apakah aplikasi atau situs tersebut hanya menggunakan gabungan elemen sintaks dasar, atau semua elemen dasar dan sintaks lanjut digabungkan, atau beberapa kombinasi elemen sebarang sintaks? Anda tidak akan tahu sampai Anda membaca dokumentasi atau mulai menggunakan aplikasi tersebut.

Jika Anda baru memulai, saran terbaik yang dapat diberikan kepada Anda adalah memilih aplikasi Markdown dengan dukungan Markdown yang baik. Itu akan sangat jauh untuk mempertahankan portabilitas file Markdown Anda. Anda mungkin ingin menyimpan dan menggunakan file Markdown di aplikasi lain, dan untuk melakukan itu Anda perlu memulai dengan aplikasi yang memberikan dukungan yang baik. Anda dapat menggunakan direktori alat bantu untuk menemukan aplikasi yang sesuai dengan selera cita rasa Anda!

Sumber-sumber Tambahan

Terdapat banyak sumber informasi di Internet dan rujukan untuk belajar Markdown. Berikut adalah daftar terbatas sumber-sumber tersebut.

• Dokumentasi Markdown John Gruber. Panduan asli yang ditulis oleh pembuat Markdown.
• Tutorial Markdown. Sebuah situs sumber terbuka yang memungkinkan Anda mencoba Markdown di browser Internet Anda.
• Markdown Keren. Daftar alat bantu dan sumber belajar Markdown.
• Typesetting Markdown. Suatu serial (informasi rutin) yang menjelaskan ekosistem untuk mengolah dokumen Markdown menggunakan pandoc dan ConTeXt.

Tingkatkan keterampilan Markdown Anda

Pelajari Markdown dalam 60 halaman. Dirancang untuk pemula dan ahli, buku Panduan Markdown ini adalah referensi komprehensif yang memiliki semua yang Anda butuhkan untuk memulai dan menguasai sintaks Markdown.

Dapatkan buku tersebut