Pengenalan Penurunan Nilai

Penurunan harga

Markdown adalah alat penukaran teks ke HTML. Hari ini ia menjadi de facto-sinonim untuk kelas bahasa penerangan penanda ringan. Ia menggunakan sintaks pemformatan teks biasa. Idea di sebalik Markdown adalah untuk membuat penulisan halaman web dan terutamanya entri blog semudah menulis e-mel. Pada masa November 2017, matlamat tercapai dan Markdown serta turunannya Asciidoc, Asciidoctor dan Asciidoctor-pdf banyak digunakan.

Markdown hanya memfokuskan pada teks biasa dan menjauhi semua kerumitan lain seperti yang terdapat dalam HTML. Ia mudah dipelajari kerana dijaga sederhana, oleh itu juga lebih cepat kerana watak minimal digunakan, yang menyebabkan kemungkinan ada kesalahan juga pada akhirnya. Lihat gambar 1 untuk dokumen asas yang ditunjukkan dalam editor Markdown Stackedit. Di sebelah kiri anda melihat kod sumber dan di sebelah kanan output HTML yang sesuai. Anda mungkin melihat bahawa tajuk utama hanya ditandai dengan sejumlah # sesuai dengan tahap hierarki tajuk utama.

Penukaran Teks

Teks biasa boleh ditukar ke XHTML (HTML) dan banyak format lain menggunakan alat baris perintah seperti Markdown atau Pandoc. Pada asasnya, kedua-dua alat ini hanya membuat serpihan HTML dan menuliskan output ke stdout. Pandoc menawarkan pertukaran “-o filename” untuk menulis output HTML ke fail yang diberikan. Seperti yang dilihat di bawah, fail output dinamakan asas.html dan mengandungi fragmen HTML - dua tajuk utama dan satu perenggan.

$ pandoc -o asas.asas html.md $ asas kucing.html 
Pembuatan Pakej Debian HowTo
 
Kata Pengantar
 Bertanggungjawab terhadap mesin bermaksud menjaga perkakasan dan juga komponen perisian. Seperti yang dilihat dalam kehidupan seharian sebagai pentadbir sistem, lebih baik memasang perisian sebagai pakej perisian daripada sekumpulan fail sumber. Ini mengurangkan kos untuk menjaga sistem dengan betul. $ 

Untuk membuat dokumen HTML yang berdiri sendiri dengan tajuk HTML lengkap Pandoc menerima pertukaran "-s" seperti berikut:

$ pandoc -o asas.html -s asas.md $ asas kucing.html           
Pembuatan Pakej Debian HowTo
 
Kata Pengantar
 Bertanggungjawab terhadap mesin bermaksud menjaga perkakasan dan juga komponen perisian. Seperti yang dilihat dalam kehidupan seharian sebagai pentadbir sistem, lebih baik memasang perisian sebagai pakej perisian daripada sekumpulan fail sumber. Ini mengurangkan kos untuk menjaga sistem dengan betul.   

Kelebihan menjaga kandungan terpisah dari paparan visual anda adalah bahawa ia tidak akan merosakkan rupa laman web anda. Versi 1.0.1, yang dikembangkan oleh John Gruber dan Aaron Swartz dikeluarkan pada bulan Disember 2004 dan boleh didapati sebagai perisian percuma (lihat pautan di akhir artikel ini).

Elemen teks

Tajuk utama

Mengikut tahap HTML yang sesuai, tajuk utama ditulis dengan sejumlah # seperti berikut:

# H1 ## H2 ### H3 #### H4 ##### H5 ###### H6 

Untuk H1 dan H2 dua kaedah penulisan alternatif diterima:

H1 == H2 -- 

Harap maklum bahawa bilangan tanda atau tanda sempang sama dengan bilangan watak tajuk utama.

Menekankan Teks

Untuk menekankan teks, elemen-elemen ini disokong:

• miring: tanda bintang tunggal atau garis bawah tunggal
  --
  * penting * dan _juga penting_
  --
• teks tebal: tanda bintang dua atau garis bawah dua
  --
  ** penting ** dan __sangat penting__
  --
• teks bersilang: tildes berganda
  --
  ~~ teks ~~
  --

Senarai

Markdown menyokong senarai yang tidak tersusun dan tersusun. Senarai yang disusun bermula dengan tanda bintang, tanda tambah atau tolak. Senarai yang disusun hanya bermula dengan angka. Untuk membuat sublists indentasikan listitem dengan dua ruang (Markdown, StackEdit) atau empat ruang (Pandoc) seperti yang anda lihat di bawah:

1. buah-buahan * epal * pisang 2. minuman + air + susu 

Gambar

Cara termudah adalah dengan menggunakan gaya sebaris seperti berikut:

![Logo Debian] (logo debian.png "Logo Debian") 

Ini memaparkan gambar yang dirujuk. Sebaik sahaja anda menggerakkan penunjuk tetikus ke atas gambar, anda akan melihat teks keterangan yang sesuai.

Penyorotan Kod dan Sintaks

Terdapat dua varian - kod sebaris dan blok kod. Kod sebaris dibingkai dalam tiga tanda belakang seperti cetakan “'(“ Hello, world!")" '. Blok kod juga bermula dan diakhiri dengan tiga backtick tetapi pada baris yang terpisah seperti berikut:

"cetak (" Helo, dunia!")"

Markdown tidak menyokong sorotan sintaks tetapi dialek seperti Markdown Here.

Jadual

Markdown tidak menyokong jadual tetapi sambungan seperti GFM dan Markdown Here.

Petikan blok

Blockquotes hanya bermula dengan tanda ">". Ia menjadi sangat berguna untuk memetik teks.

> "Oh! adalah tidak masuk akal untuk mempunyai peraturan yang sukar dan cepat mengenai apa yang harus> dibaca dan mana yang tidak seharusnya. Lebih daripada separuh budaya moden bergantung pada apa yang tidak boleh dibaca oleh seseorang.">> Kepentingan Menjana Pendapatan. (Oscar Wilde) 

Pautan

Pautan merujuk kepada dokumen lain atau bahagian dalam dokumen semasa. Gaya penulisan serupa dengan gambar dan terdiri daripada keterangan pautan dalam tanda kurung persegi dan URL dalam tanda kurung biasa.

[Saya pautan gaya sebaris] (https: // linuxhint.com) 

Selanjutnya, anda boleh menambahkan teks alternatif:

[Saya pautan gaya sebaris dengan teks tambahan] (https: // linuxhint.com "LinuxHint") 

Pautan boleh dirujuk seperti berikut:

[LinuxHint] [1] ... beberapa teks ... [1]: https: // linuxhint.com 

Ini membolehkan anda membuat senarai rujukan dengan mudah di akhir dokumen anda kerana perkara biasa dalam dokumen saintifik.

Kesimpulannya

Markdown cukup mudah dan mustahak bagi semua orang yang melakukan dokumentasi dan menerbitkan kandungan secara berkala. Sangat senang menggunakannya.

Rujukan

• StackEdit, https: // stackedit.io / penyunting
• Pandoc, http: // pandoc.org /
• Markdown, https: // daringfireball.bersih / projek / penurunan harga /
• Markdown Cheatsheet, https: // github.com / adam-p / markdown-here / wiki / Markdown-Cheatsheet