Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Tools & Tips

Markdown: Seluk Beluk

by
Difficulty:BeginnerLength:MediumLanguages:

Indonesian (Bahasa Indonesia) translation by ⚡ Rova Rindrata (you can also view the original English article)

Markdown adalah bahasa markup sederhana yang sangat mengejutkan yang memungkinkan Anda menulis, menggunakan format teks biasa yang mudah dibaca, mudah-untuk-menulis. Format ini kemudian bisa, dalam hitungan detik, diubah menjadi bahasa markup lainnya, seperti HTML!

Jika Anda tidak mengenalnya, saya akan mengajari Anda tentang hal itu hari ini!

Markdown melakukan pekerjaan yang fantastis untuk keluar dari jalur.

Markdown melakukan pekerjaan yang fantastis untuk keluar dari jalur. Saya yakin semua orang memiliki, pada titik tertentu, teks emphasis dalam dokumen teks biasa dengan mengelilingi ungkapan tersebut dengan tanda bintang, *seperti*. Begitulah cara kerjanya dalam markdown! Memberikan emphasis ekstra (menebalkan kata) adalah sesederhana **dua kali lipat asterix**.

Tidak mengherankan jika filosofi Markdown adalah menghasilkan konten, yang bisa "diterbitkan seperti apa adanya, tanpa terlihat seperti di-markup dengan tag-tag."

Manfaatnya harus jelas bagi siapa saja yang mencoba menulis konten berbasis web dan harus khawatir memformatnya juga. <em>teks di sini</em> terlalu sulit untuk diketik, begitu otak Anda mengalir - belum lagi bagaimana hiruk-pikuk tag HTML yang mengganggu sebuah dokumen dapat merusak keterbacaan saat Anda sedang memeriksa dokumen.

Sejumlah editor Markdown sudah ada, baik berbasis web dan desktop, namun Anda bisa, tentu saja, menggunakan editor teks lama apa pun. Satu-satunya keuntungan yang diberikan oleh editor Markdown khusus adalah pratinjau langsung dari HTML yang dihasilkan, dan, biasanya, beberapa tingkat penyorotan sintaks.

Jika Anda ingin mencoba contoh di bawah ini, lihat konverter berbasis browser Dingus resmi.


Markup

Paragraf

Dengan Markdown, teks secara otomatis dikonversi menjadi paragraf di mana blok teks dipisahkan oleh baris kosong. Dan bukan hanya beberapa tag <br> seperti WYSIWYG dari hari-hari yang berlalu, tapi paragraf semantik <p> sebenarnya. Ini hampir seperti ilmu hitam.

Cukup menjadi:

Satu keanehan kecil dengan Markdown adalah bagaimana satu jeda baris ditangani. Filosofi Markdown adalah bahwa browser harus menangani jeda baris, dan bukan yang lain. Jadi teks berikut ini:

Menjadi, cukup mengejutkan:

Jika Anda benar-benar harus memasukkan jeda baris, ada solusi yang tersedia: cukup tambahkan dua spasi ke akhir baris sebelumnya, seperti:

Sejumlah "rasa" Markdown dapat menangani jeda baris dengan cara yang Anda harapkan, namun lebih banyak lagi nanti.

Judul

Mulailah sebuah paragraf dengan sebuah #, dan paragraf itu menjadi judul. Jumlah # menandakan nomor tingkat judul (<h1>, <h2> dll.)

Menjadi:

Sintaks alternatif juga disediakan untuk <h1> dan <h2>, seperti:

Blockquotes

Salah satu pengaruh utama Markdown adalah email teks biasa, dan ini sangat jelas, ketika Anda melihat bahwa blockquotes diformat persis seperti di email: diawali dengan sebuah >:

...Yang mengkonversi ke:

Kode

Anda dapat membatasi cuplikan kode kecil, dengan menggunakan karakter ` di sekitar kode.

Blok kode yang lebih besar dapat didefinisikan hanya dengan memberi indentasi kode sampai sebuah level (setidaknya satu tab/empat spasi) - tingkat indentasi akan dihapus. Markdown secara otomatis meng-escape dari semua karakter khusus di dalam blok kode, yang berarti Anda dapat dengan aman menyalin di blok kode tanpa meng-escape secara manual < menjadi &lt; dan > menjadi &gt; dll.


Daftar

Contoh nyata lain tentang bagaimana Markdown hanya datang secara alami adalah bagaimana Anda menentukan daftar. Cukup mulai paragraf dengan * (atau +, -) untuk membuat sebuah unordered list. Gunakan nomor, 1., 2. dll. untuk ordered lists:


Elemen Teks Sejajar

Kita sudah membahasnya dengan huruf miring dan teks tebal pada awal artikel ini (* dan **), namun Anda juga bisa menukar asterix untuk garis bawah, jika Anda lebih suka:

Tautan adalah bagus dan sederhana dalam Markdown (jika Anda dapat berkomitmen untuk mengingat apakah itu tanda kurung siku-siku dan bulat yang datang lebih dulu…):

Untuk menampilkan gambar, awali kode tautannya dengan sebuah !:

Markdown tidak Menghalangi Jalan Anda

Markdown sangat ringan, bila harus melanggar markupnya dan hanya menggunakan HTML saja. Jika Anda perlu menyertakan tabel, sertakan dalam HTML. Atau, jika Anda lebih suka menulis tautan Anda dalam format HTML, Anda dapat melakukannya. Markdown cukup cerdas untuk mengetahui saat Anda bermaksud menyertakan HTML, dan bekerja di sekitarnya.

Markdown juga otomatis meng-escape karakter-karakter, seperti &, < dan > ke dalam bentuk entitas HTML. Bahkan dengan cerdas mengubah kombinasi karakter yang umum menjadi apa yang sebenarnya Anda maksudkan.

  • Tiga titik secara otomatis akan menjadi elipsis: …
  • Dua tanda hubung akan menjadi en-dash: --
  • Tanda quote akan menjadi "mewah", versi melengkung dari diri mereka sendiri.

Rasa & Markdown Berasa GitHub

Ada sejumlah alternatif "rasa" Markdown, yang memperpanjang set standar aturan Markdown. Ekstensi yang umum adalah line-breaking yang mudah, seperti yang dijelaskan di atas. Salah satu rasa Markdown yang paling terkenal adalah GitHub's Flavored Markdown. Ini digunakan untuk markup masukan pengguna di mana saja di situs mereka. Serta termasuk dukungan line-breaking yang lebih baik dan sejumlah kustomisasi yang spesifik untuk GitHub, fitur favorit saya adalah alternatifnya untuk pembuatan kode, yang juga memungkinkan Anda untuk menentukan sintaks untuk penyorotan. Cukup kelilingi kode dengan ``` di kedua sisi, termasuk bahasa di awal, seperti:


Konversi

Konverter Markdown Tuts+ dapat ditemukan di sini.

Konverter Markdown Tuts+ dapat ditemukan di sini.Konverter resmi ditulis dalam Perl, dan tersedia untuk diunduh di beranda Markdown di Daring Fireball. Beberapa konverter Markdown lainnya juga ada, untuk banyak bahasa yang berbeda - dari C... hingga Ruby... ke JavaScript... ke PHP. Daftar lengkap implementasi dapat ditemukan di Wikipedia.

Salah satu implementasi Ruby yang populer adalah RedCarpet, berdasarkan pada perpustakaan C, Sundown, yang menyediakan cara yang sangat sederhana untuk menyesuaikan keluaran dari HTML yang dihasilkan untuk menghasilkan "rasa" Markdown Anda sendiri.

Baru-baru ini, saya menggunakan perpustakaan ini untuk membuat konverter Markdown, yang menerima GitHub Flavored Markdown (untuk mengizinkan menentukan bahasa kode untuk penyorotan sintaks), dan menampilkan HTML yang dikonversi dengan gaya spesifik yang diminta oleh situs Tuts+. Konverter Markdown Tuts+ dapat ditemukan di sini. Jika Anda pernah menulis tutorial untuk situs ini, pastikan menggunakannya!

Sebenarnya, artikel ini ditulis dalam Markdown, menggunakan editor Mou Markdown yang populer untuk OSX.

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.