Panduan Menulis File Markdown - *.md file ekstension

Markdown adalah standar yang digunakan secara luas untuk mendistribusikan berkas teks dengan sintaksis khusus yang dapat dengan mudah dipahami dan diformat oleh perangkat lunak modern, menghilangkan kebutuhan untuk menulis keseluruhan kode HTML.

Anggap saja ini cara untuk menambahkan gaya dan struktur HTML ke dokumen teks Anda dengan cara yang mudah dibaca dan dipahami oleh orang-orang yang tidak memiliki pengalaman dalam membuat kode.

Sekilas Tentang File Markdown (*.md)

Saat ini ada 2 pilihan bagi akademisi yang ingin menulis laporan/makalah teknis: Microsoft Word atau LaTeX. Dari sudut pandang penulis, penggunaan What You See Is What You Get (WYSIWYG) seperti Microsoft Word, WPS Office, atau LIbreOffice mungkin lebih praktis, karena format dokumen dapat dilihat secara langsung. Namun, spesifikasi sintaksis yang rumit sering kali menimbulkan masalah saat menggunakan versi perangkat lunak yang berbeda dan untuk penulisan kolaboratif. Konversi sederhana antara format file bisa jadi sulit atau tidak mungkin dilakukan.

Penulis akademis mungkin juga menghadapi masalah perubahan mendadak dalam struktur dokumen; bahkan dengan penyisipan satu huruf. Hal ini menjadi masalah saat mengerjakan laporan besar yang menyebabkan kejengkelan dan frustrasi. Tidak hanya itu, ini sangat lambat dan dapat menghabiskan memori virtual yang besar, terkadang hingga satu giga.

Akan menjadi masalah jika Anda harus mengonversi berkas Anda ke format berkas yang berbeda karena berbagai alasan. Misalnya:

1. Untuk mengirimkan naskah jurnal untuk ditinjau sejawat dalam DOCX, serta versi pracetak dengan gaya lain dalam PDF.
2. Untuk mengirimkan naskah Anda ke jurnal dengan gaya kutipan yang sangat berbeda.
3. Untuk menerbitkan buku dengan versi cetak dalam PDF dan versi elektronik dalam EPUB.

Di sisi lain, beberapa orang bekerja dengan LaTeX; khususnya di komunitas ilmiah. Dengan LaTeX, dokumen dengan kualitas tipografi yang tinggi dapat diproduksi. Namun, berkas sumber dipenuhi dengan perintah LaTeX dan teks sumber dapat menjadi rumit untuk dibaca. Oleh karena itu, LaTeX tidak ramah pengguna, terutama bagi penulis biasa atau pemula.

Markdown adalah bahasa markup teks biasa yang ringan dan mudah dibaca serta ditulis. Bahasa ini dapat dengan mudah diubah ke dalam format umum, seperti PDF, HTML, DOCX atau EPUB menggunakan Pandoc. John Gruber, pengembang asli Markdown, mendefinisikan tujuan Markdown sebagai berikut:

"Sasaran desain utama untuk sintaksis pemformatan Markdown adalah membuatnya semudah mungkin dibaca. Idenya adalah bahwa dokumen berformat Markdown harus dapat dipublikasikan apa adanya, sebagai teks biasa, tanpa terlihat seperti telah diberi tag atau instruksi pemformatan."

Cara Nulis file Markdown

Untuk mempermudah pembelajaran pembuaan teks Markdown, kita gunakan saja Github. Untuk melaksanakannya anda bisa buat repositori baru atau gunakan repositori yang sudah ada (karena untuk pembeljaran).

a. Buat  Heading untuk Judul atau sub Judul

Pada bagian pertama ini kita akan membuat heading untuk judul atau sub judul.

# Heading 1 - Judul Tulisan
## Heading 2 - Judul/Sub Judul Tulisan
### Heading 3 - Judul/Sub Judul Tulisan
#### Heading 4 - Judul/Sub Judul Tulisan
##### Heading 5 - Judul/Sub Judul Tulisan
###### Heading 6 - Judul/Sub Judul Tulisan

Sintaks "#" menandakan Judul atau sub judul tersebut. Jumlah dari "#" menunjukkan judul/sub juduk tersebut termasuk kategori Heading1, Heading 2, Heading 3 dan lainnya.

b. Buat  Tulisan dengan Format Bold dan Italic

**Ini adalah contoh tulisan BOLD**
*Ini adalah contoh tulisan italic*

c. Buat  Tulisan dengan Format blockquotes

> single blockquotes

> blockquotes
>> nested blockquotes

d. Buat  Garis Horizontal (atau pemisah)

---
cara Membuat garis Horizontal atau garis pemisah gunakan sintaks "---"

e. Buat tulisan dengan Numbered List dan Bulleted List

### Nama-Nama Buah
1. Pisang
2. Jeruk
3. Nanas

### Nama-Nama Buah
- Apel
  - green apple
  - red apple
- Jeruk
- Nanas

f. Buat Blok Kode

`$ initdb -D /var/postgresql/data/ -U postgres -k -E UTF-8 -A md5 -W`

```
postgres=# CREATE ROLE bromo SUPERUSER;
postgres=# ALTER ROLE bromo PASSWORD 'ranupani1234'
postgres-# ALTER USER bromo PASSWORD 'ranupani1234' LOGIN;
postgres=# \q
```

g. Menambahkan Teks Insert Link

Untuk mempermudah pembelajaran pembuaan teks Markdown, kita gunakan saja [Github](https://github.com/iwanse1977/qiita-article/blob/main/cara-nulis-markdown.md). Untuk melaksanakannya anda bisa buat repositori baru atau gunakan repositori yang sudah ada (karena untuk pembeljaran).

h. Membuat Tabel

| Nomor       | Nama          | Umur        | 
| ----------- | -----------   | ----------- |
| 01          | Udin          | 36          |
| 02          | Aminudin      | 25          |
| 03          | Salahudin     | 24          |
| 04          | Udin sedunia  | 47          |

Semua sintaks Markdown yang disebutkan dalam artikel ini adalah standar dan didukung secara native oleh semua prosesor Markdown. Akan tetapi, ada sejumlah prosesor lain yang menyediakan fitur tambahan yang dapat Anda manfaatkan.