markdown guide beginner tutorial

Apa itu Markdown? Panduan Bahasa yang Sederhana untuk Pemula

Panduan pemula untuk Markdown apa itu, mengapa dibuat, di mana digunakan, dan bagaimana memulai menulisnya hari ini. Tidak perlu pengalaman sebelumnya.

W
WordToMD Tim
·

Markdown adalah sintaksis pemformatan teks ringan yang mengubah teks biasa menjadi dokumen terstruktur. Dibuat pada tahun 2004 oleh John Gruber, sekarang ini adalah format standar untuk dokumentasi, file README, posting blog, dan komunikasi pengembang. Panduan ini menjelaskan apa itu Markdown, mengapa orang menggunakannya, dan bagaimana memulai.

Apa itu Markdown?

Markdown adalah cara untuk menambahkan pemformatan ke teks polos menggunakan karakter tanda baca sederhana. Anda menulis dalam editor teks, dan Markdown dibuat menjadi format output (HTML, PDF, dll.) oleh prosesor.

Misalnya:

# This is a Heading

This is a **bold word** and this is *italic*.

- List item one
- List item two

Render sebagai:

Ini adalah Judul

Ini adalah kata tebal dan ini adalah italic.

  • Daftar item pertama
  • Daftar item dua

Pemformatan hidup dalam teks itu sendiri tidak ada XML tersembunyi, tidak ada format biner, tidak ada pengkodean proprietari.

Mengapa Markdown Diciptakan?

Sebelum Markdown, penulis web menghadapi pilihan: menulis dalam HTML mentah (menjengkelkan dan rentan terhadap kesalahan) atau menggunakan editor WYSIWYG yang menghasilkan kode yang berantakan. John Gruber merancang Markdown untuk menjadi:

  1. Membaca sebagaimana adanya Bahkan tanpa rendering, **bold** dibaca dengan jelas sebagai penekanan
  2. Bisa ditulis oleh siapapun Tidak ada perangkat lunak khusus, hanya editor teks
  3. Konversi ke HTML Format output utama

Spesifikasi asli berfokus pada produksi HTML yang bersih. Tapi Markdown sejak itu telah menyebar ke lusinan platform dan format output.

Di mana Markdown Digunakan?

Markdown ada di mana-mana dalam teknologi:

PlatformApa yang dilakukan Markdown
GitHubREADME, masalah, permintaan penarikan, wiki
NotionIsi halaman dan dokumen
ObsidianSemua catatan di lemari besi
WordPress (dalam bahasa Inggris)Posting melalui Markdown plugin
GitBookHalaman dokumentasi
Lemah / KetidakpercayaanFormat pesan
Overflow tumpukanPertanyaan dan jawaban
Jekyll / Hugo / AstroPosting blog dan halaman statis
Buku Catatan JupiterSel dokumentasi

Jika Anda menulis konten teknis, Anda hampir pasti telah menemukan Markdown.

Markdown vs. Word: Perbedaan Utama

AspekWordMarkdown
FormatBiner (.docx)Teks kosong (.md)
PortabilitasMemerlukan Word atau aplikasi yang kompatibelDibuka dalam editor teks apa pun
Pengendalian versiSulit (perbedaan biner)Mudah (perbedaan Git baris demi baris)
RenderingDibangun ke dalam aplikasiMemerlukan Markdown renderer
Kurva pembelajaranWYSIWYG (tidak belajar)Memerlukan pembelajaran sintaksis
Dukungan platformEkosistem MicrosoftAlat pengembang universal

Jika Anda memiliki Word dokumen Anda ingin mengonversi ke Markdown, WordToMD Tidak ada pendaftaran, tidak ada upload.

Dasar Markdown Sintaksis

Berikut adalah elemen yang paling umum:

Posisi

# Heading 1
## Heading 2
### Heading 3

Lihat Markdown Panduan Judul untuk referensi penuh.

Penekanan

**Bold text**
*Italic text*
~~Strikethrough~~

Daftar

- Unordered item
- Another item
  - Nested item

1. First
2. Second
3. Third
[Link text](https://example.com)

Gambar-gambar

![Alt text](image.png)

Kode

Inline: `code snippet`

Block:
```python
print("Hello, Markdown!")

See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).

### Tables

```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |

Lihat Markdown Tabel: Panduan Lengkap.

Kuota blok

> This is a blockquote.
> It can span multiple lines.

Markdown Rasa

Markdown bukan satu standar ada beberapa varian:

  • CommonMark Spesifikasi yang ketat dan tidak ambigu
  • GitHub Beraroma Markdown (GFM) CommonMark + tabel, daftar tugas, pencitraan, tautan otomatis
  • MultiMarkdown Menambahkan catatan kaki, kutipan, metadata
  • Pandoc Markdown Paling kaya fitur, digunakan oleh Pandoc converter

Sebagian besar platform mendukung setidaknya CommonMark. GitHub, Obsidian, dan GitBook menggunakan GFM. Untuk referensi lengkap, lihat Markdown Sintaksis panduan ringkas.

Cara Menulis Markdown

Anda tidak perlu perangkat lunak khusus. Opsi termasuk:

  • Kode VS Gratis, editor yang kuat dengan built-in Markdown preview
  • Obsidian Markdown aplikasi pencatatan dengan tampilan grafik
  • Typora WYSIWYG Markdown editor
  • iA Penulis Lingkungan penulisan yang terfokus
  • Setiap editor teks biasa Notepad, TextEdit, vim, emacs

Konversi Antara Markdown dan Format Lainnya

Jika Anda memiliki Word dokumen untuk dikonversi ke Markdown, WordToMD melakukan itu dalam hitungan detik benar-benar gratis, tanpa upload file.

Untuk kebalikan (Markdown ke Word atau PDF), alat seperti Pandoc menangani konversi ini. Lihat Pandoc Word sampai Markdown untuk instruksi pengaturan.

FAQ

Apakah Markdown adalah bahasa pemrograman? Tidak, aku tidak. Markdown adalah bahasa markup itu menggambarkan pemformatan, bukan logika atau komputasi.

Dapatkah saya menggunakan Markdown dalam Microsoft Word? Word tidak render Markdown secara asli, tetapi ada Word add-in yang menambahkan dukungan Markdown. Atau, konversi Word ke Markdown dengan WordToMD dan gunakan Markdown editor.

Apakah Markdown baik untuk dokumen panjang? Ya, dengan struktur arah yang baik. Dokumen yang sangat panjang mendapat manfaat dari pemisahan menjadi beberapa file (seperti dalam GitBook atau Obsidian vault).

Ekstensi file apa yang digunakan Markdown? .md adalah standar. .markdown juga berlaku. Beberapa platform menggunakan .mdx untuk Markdown dengan komponen JSX (React).

Kesimpulan

Markdown adalah format yang sederhana dan kuat yang telah menjadi lingua franca penulisan teknis. Ini dapat dibaca sebagai teks biasa, merender dengan indah, dan bekerja dengan setiap alat pengembang utama. Jika Anda baru untuk itu, mulai dengan Markdown Sintaksis panduan ringkas dan mencoba mengkonversi dokumen Word pertama Anda di WordToMD.