Markdown教學

By A小編 2022/11/12、2023/01/25更新
分享
markdown

圖片來源: Markdown 語法說明

聲明:A小編會推薦的小技巧,對A小編而言很合適,但不一定適合你。不過若你有興趣多學一個小技巧的話,請參考看看。註:建議用電腦瀏覽此篇文章。

技巧難易度:中

實用程度:

前言

 Markdown 是一種標記語言,簡單來說就是透過一些簡單的符號來達成一些文字的特殊屬性。什麼編輯器都可以打 Markdown ,只要那份文件的副檔名 .md ,它就是一份 Markdown 文件。在此篇文章中,都是使用 Obsidian 來示範的。關於 Markdown 的編輯器,在本篇不多加贅述,有興趣的人請參考這篇 Markdown軟體推薦。當然同一種樣式可能有很多種打法。 先說明一下, Markdown 的語法是要用英文輸入法來打的,所以要打非英文的語言的話,可能會需要來回切換輸入法。在本篇,A小編來跟大家介紹一下A小編自己常用的 Markdown 語法:

標題、文字標記打法

  1. 標題字:先打#,然後空一格(英文的空格),再打字,#可以打一個到六個,打一個最大,打六個最小。如果你稍微懂一點 html 的話,就是 h1 到 h6 標題大小的概念。範例如下:
    • # 範例

    • ## 範例

    • ### 範例

    • #### 範例

    • ##### 範例
    • ###### 範例
  2. 斜體:在文字兩側打*文字*。
  3. 粗體:在文字兩側打**文字**。
  4. 高亮:在文字兩側打==文字==。不過這個有些程式不支援,可以改打:
     <mark>文字</mark>
                    
  5. 其呈現效果是一樣的。都是:文字

  6. 刪除線:在文字兩側打~~文字~~。

有序清單

再來教大家打清單,清單分成兩種,有序清單和無序清單。有序清單就先打好數字,再打一個英文的句號,然後空一格即可,如下:

  1. 範例文字
  2. 範例文字
  3. 範例文字
  4. 範例文字

無序清單

再來是無序清單。無序清單就先打好 - ,然後空一格即可。到這裏或許有人會問,這些格式可以混在一起嗎,當然可以!你可以既高亮文字的同時,又粗體,而且這是可以用在清單裏的,甚至是標題也行。範例如下:

子清單

當然,清單裏面還可以再夾「子清單」:不論是有序清單裏面再夾有序清單,或有序清單夾無序清單;亦或是無序清單裏夾有序清單,或者是無序清單裏夾無序清單,這些 Markdown 都做得到!只要在現有的清單的下面一行先按一下「tab」鍵,再打清單的數字或符號即可。範例如下:

引用

然後,教大家打「引用」的打法,先打一個>,然後空一格,再打你想要的內容。如下圖所示,有被編輯器渲染後的結果。

example
example

短區塊

再來是短區塊的打法。先打``,然後在``中間打你要打的內容。如下圖所示,第二張圖是有被編輯器渲染後的結果。

example
example

程式碼區塊

這個功能也是讓軟體工程師喜歡用 Markdown 打程式的說明文件的原因,它可以高亮程式的語法,使程式碼更易讀。先打 ```xxxxxx 就打上你要用的語言,如:Shell、Python、C 等等。再打一組 ``` 把所有程式碼給包起來。範例如下圖所示,第二張圖是有被編輯器渲染後的結果,而且如第二張圖的右上紅圈處所示,只要點下該處即可複製所有該區塊所有的程式碼。

example
example

分隔線

只要打 --- ,即可在幾乎所有的 Markdown 編輯器裏(前提是能渲染的)渲染出分隔線。效果如下二圖所示。

example
example

在 Markdown 中,要插入超連結的話也非常簡單。只要打 [標題](網址) ,即可渲染出簡潔的超連結。如下二圖所示。

example
example

上面的超連結打法稱作「行內連結」,雖然簡潔明瞭,但是如果你的超連結是打在文章段落裏面的話,就會使你的 Markdown 原始碼非常的亂。如下所示:


今天[天氣真好](https://www.youtube.com/watch?v=YDVbJaoxeF8),
他們決定去一個
[沒有人的地方](https://www.youtube.com/watch?v=RHTyk1GJFJs)放鬆。
一路上風光明媚,心情好不美麗。
終於快到[目的地](https://www.youtube.com/watch?v=_9d3OQ1jLBM)了。
	

下面,A小編要教大家另一種超連結的打法,稱作「引用式連結」。其原始碼如下所示:


今天[天氣真好][],
他們決定去一個
[沒有人的地方][]放鬆。
一路上風光明媚,心情好不美麗。
終於快到[目的地][]了。

[天氣真好]: https://www.youtube.com/watch?v=YDVbJaoxeF8
[沒有人的地方]: https://www.youtube.com/watch?v=RHTyk1GJFJs
[目的地]: https://www.youtube.com/watch?v=_9d3OQ1jLBM
	

這種「引用式連結」的好處就是讓 Markdown 的原始碼的可讀性大大增加,各位可以看情況,再決定要使用哪一種打法。

關於「引用式連結」,如果想瞭解更多的話,可以參考少數派的這篇文章:在 Markdown 中使用引用式链接和脚注

表格

在 Markdown 文件中,也可以建立表格。 Markdown 使用 - | 來畫表格,具體說明如下:


| Lorems      | Loremasaqef |
| ----------- | ----------- |
| loersa      | aksd        |
| aExamples   | abcd        |
                    

用 | 來分隔列,- 的上面那一列爲標題。當然上面的範例是有畫整齊的,不過就算沒有畫整齊,最後渲染出來的結果還是是整齊的,效果如下圖。


|Lorems|Loremasaqef|
| ----------- | ----------- |
|loersa|aksd|
|aExamples|abcd|
        
example

當然,你也可以讓表格的內容靠左對齊、靠右對齊或置中。如下範例,在 - 左側加入 : 以實現靠左對齊;加在右邊以實現靠右對齊;加兩側就置中。沒加的話,預設是靠左對齊。


| aaaaaaaaa | ccccccccccc | ddddddddddd |
| :---|:------:|-----: |
| aa | cccc | dddd |
| aa | cccc | dddd |
        
example

小技巧

在打 Markdown 文件的時候,可以適時地在標題及內文之間空一行,這樣不僅比較美觀,也可以提升易讀性。此外,如果你是瞭解 html 的人的話,適時地在 Markdown 文件中使用 html 也能使你的文件渲染後更美觀喲!

結語

 Markdown 作爲一個筆記的工具,不光是A小編,大部分喜歡用的人覺得它最方便的地方就是,你不需要管排版、格式,相信很多人都有用 Word 調格式調到快發瘋的經驗,但是 Markdown 就不會有這些問題,不管你怎麼打,用什麼編輯器,最後渲染出來的結果基本上都不會差太多。

好了,那以上就是這次的內容,若能使您的生活更加便利的話,那是再好也不為過了!