Markdown 是一種由 John Gruber 於 2004 年創建的輕量級標記語言,其核心設計理念是「易讀易寫」。它允許使用者使用簡單的純文字符號來排版,並能輕鬆轉換為結構化的 HTML 文檔。
以下是針對 Markdown 的完整介紹與使用說明:
一、 為什麼要使用 Markdown?
- 可攜性與永不過時:Markdown 檔案本質上是純文字(.md),任何作業系統或裝置在幾十年後都能開啟,不會有格式跑掉或版本相容性問題。
- 專注於內容結構:與 Word 不同,Markdown 強調文檔的邏輯結構而非排版樣式,避免了在寫作時被複雜的工具列干擾。
- 廣泛支援:目前 GitHub、Notion、Discord、Reddit、Obsidian 以及許多技術部落格都原生支援 Markdown。
二、 核心語法教學
掌握以下 7 個基礎規則,即可處理 90% 的寫作需求:
1. 標題 (Headers)
在文字前加上 # 號,並保留一個空格。# 的數量代表標題等級,支援 1 到 6 階。
# 一級標題(對應 HTML 的<h1>)## 二級標題###### 六級標題
2. 強調文字 (Emphasis)
- 粗體:使用兩個星號
**文字**或底線__文字__。 - 斜體:使用一個星號
*文字*或底線_文字_。 - ~~刪除線~~:使用兩個波浪號
~~文字~~(屬於 GFM 擴展語法)。
3. 清單 (Lists)
- 無序清單:使用
*、+或-開頭。 - 有序清單:使用數字加上英文句點,如
1.。 - 任務列表 (CheckBox):使用
- [ ]表示未完成,- [x]表示已完成。
4. 連結與圖片 (Links & Images)
- 連結:
[顯示文字](網址)。 - 圖片:與連結語法相似,但開頭多一個驚嘆號
。
5. 程式碼 (Code)
- 行內程式碼:使用單反引號
`code`包圍文字。 - 程式碼區塊:使用三個反引號
包圍多行程式碼,並可在開頭標註語言名稱(如py或js)以實現語法高亮。
6. 引用 (Blockquotes)
在每行開頭加上大於符號 >,常用於引用他人的話或強調重點。
7. 分隔線 (Horizontal Rules)
在單獨一行中使用三個以上的星號 ***、減號 --- 或底線 ___。
三、 進階與特殊語法
許多平台(如 GitHub 或 HackMD)支援額外的擴展語法:
- 表格 (Tables):使用
|分隔欄位,並用-建立標頭與內容的分隔線。| 標題 | 內容 | | ---- | ---- | | A | B | - 數學公式 (MathJax):使用單個
$包圍行內公式(如$E=mc^2$),或雙個$$包圍獨立公式區塊。 - 註腳 (Footnotes):使用
[^1]建立標記,並在文檔末尾定義[^1]: 這是說明。
四、 常見錯誤與最佳實踐
- 忘記空行:段落與段落、標題與段落之間必須有空行,否則內容會黏在一起。
- 語法中的空格:強調符號(如
**)必須緊貼文字,不能有空格(例如** 錯誤 **是無效的)。 - 圖片驚嘆號:初學者常忘記圖片語法開頭的
!,導致圖片變成一般的連結。 - 轉義字元:如果你想顯示 Markdown 的特殊符號(如
*),請在符號前加上反斜線\*。
五、 推薦工具
- 編輯器:
- Typora:所見即所得,打字時即時顯示渲染效果。
- VS Code:搭配內建預覽功能,適合開發者。
- Obsidian:適合建立個人知識庫,具備強大的連結功能。
- 線上平台:
- HackMD:強大的協作功能與特殊語法支援。
- Dillinger:不需安裝,在瀏覽器即可直接撰寫與預覽。
.png)
沒有留言:
張貼留言