Markdown adalah cara mudah untuk memformat teks menggunakan aksara biasa. Ia digunakan di mana-mana — GitHub, Reddit, Notion, Discord, dokumentasi teknikal, dan pelbagai platform lain. Daripada mengklik butang untuk menjadikan teks tebal atau mencipta tajuk, anda menaip simbol mudah. Tutorial ini mengajar anda perkara penting dan membolehkan anda berlatih menggunakan alat Pratonton Markdown percuma kami.
Apa yang anda perlukan
- Pelayar web (Chrome, Firefox, Safari, atau Edge)
- Tiada akaun atau pemasangan diperlukan
- Kira-kira 10 minit untuk mempelajari asas
Panduan langkah demi langkah
Buka alat Pratonton Markdown
Pergi ke alat Pratonton Markdown. Anda akan melihat editor skrin belah: bahagian kiri adalah tempat anda menulis Markdown, dan bahagian kanan menunjukkan pratonton berformat secara masa nyata. Setiap perubahan yang anda taip muncul serta-merta dalam pratonton.
Pelajari sintaks asas
Mula menaip dalam editor untuk bereksperimen dengan pemformatan Markdown. Sintaks teras adalah mudah dan boleh dipelajari dalam beberapa minit. Berlatih dengan contoh di bawah — taipnya di bahagian kiri dan perhatikan hasil berformat muncul di bahagian kanan.
Tulis dokumen anda
Kini tulis kandungan sebenar anda. Gunakan tajuk untuk menstrukturkan dokumen anda, senarai untuk mengatur maklumat, dan teks tebal atau condong untuk penekanan. Pratonton masa nyata memastikan anda sentiasa tahu rupa hasil akhir semasa anda menaip.
Eksport atau salin hasilnya
Setelah dokumen anda kelihatan seperti yang anda mahu, salin teks Markdown untuk digunakan pada mana-mana platform yang menyokongnya, atau eksport hasil berformat. Kandungan Markdown anda boleh ditampal ke dalam GitHub, Reddit, Notion, atau mana-mana editor yang serasi dengan Markdown.
Baik untuk diketahui Markdown direka untuk boleh dibaca walaupun tanpa pemaparan. Dokumen Markdown kelihatan bersih dan berstruktur sebagai teks biasa, yang merupakan salah satu sebab ia menjadi begitu popular.
Sintaks Markdown penting
Tajuk
Gunakan simbol # untuk mencipta tajuk. Lebih banyak simbol # bermakna tajuk yang lebih kecil:
# Tajuk 1 (paling besar)
## Tajuk 2
### Tajuk 3
#### Tajuk 4
Teks tebal dan condong
Balut teks dalam asterisk untuk penekanan:
**Ini adalah teks tebal**
*Ini adalah teks condong*
***Ini adalah teks tebal dan condong***
Senarai
Cipta senarai tidak tersusun dengan sengkang dan senarai tersusun dengan nombor:
- Item pertama
- Item kedua
- Item ketiga
1. Langkah satu
2. Langkah dua
3. Langkah tiga
Pautan
Cipta pautan yang boleh diklik menggunakan kurungan segi empat sama dan kurungan bulat:
[Teks pautan](https://example.com)
Kod
Gunakan tanda petik belakang untuk kod sebaris dan tiga tanda petik belakang untuk blok kod:
Sebaris: `console.log("hello")`
Blok kod:
```javascript
function greet(name) {
return "Hello, " + name;
}
```
Tip Anda tidak perlu menghafal semuanya sekaligus. Mulakan dengan tajuk, tebal, dan senarai — tiga perkara itu meliputi 80% penulisan Markdown yang biasa. Tambah sintaks lain apabila anda memerlukannya.
Imej
Tambah imej dengan tanda seru sebelum sintaks pautan:
Petikan blok
Gunakan > untuk mencipta teks yang dipetik:
> Ini adalah petikan blok.
> Ia boleh merentasi pelbagai baris.
Di mana Markdown digunakan
| Platform | Cara Markdown digunakan |
|---|---|
| GitHub | Fail README, isu, permintaan tarik, ulasan |
| Pemformatan siaran dan ulasan | |
| Notion | Kandungan halaman dan dokumentasi |
| Discord | Pemformatan mesej |
| Stack Overflow | Soalan, jawapan, dan ulasan |
| Penjana laman statik | Siaran blog dan kandungan halaman |
Penting Platform yang berbeza menyokong ciri Markdown yang sedikit berbeza. Asas (tajuk, tebal, condong, senarai, pautan) berfungsi di mana-mana. Ciri lanjutan seperti jadual atau nota kaki berbeza mengikut platform. Sentiasa pratonton sebelum menerbitkan pada platform baharu.
Soalan yang kerap ditanya
Apakah perbezaan antara Markdown dan HTML? Markdown ditukar kepada HTML di belakang tabir. Ia adalah cara yang lebih mudah untuk menulis teks berformat tanpa perlu mengingat tag HTML. Di mana-mana yang menerima Markdown akan memaparkannya sebagai HTML.
Bolehkah saya menggunakan Markdown untuk dokumen profesional? Sudah tentu. Banyak pasukan menggunakan Markdown untuk dokumentasi, cadangan, dan laporan. Alat wujud untuk menukar Markdown kepada PDF, Word, dan format pembentangan.
Adakah sintaksnya sama di mana-mana? Sintaks teras adalah universal. Sesetengah platform menambah sambungan (seperti GitHub Flavored Markdown yang menambah jadual dan senarai tugasan). Asas yang diliputi dalam tutorial ini berfungsi di mana-mana.
Langkah seterusnya
Kini anda mengetahui Markdown, cuba tulis README untuk projek, format siaran blog, atau cipta dokumentasi teknikal. Untuk tugasan pemformatan yang lebih lanjutan, terokai JSON Formatter kami untuk dokumentasi kod atau PDF Editor untuk output dokumen akhir.