Markdown 語法是什麼?非工程師也能看懂的原始碼

Author: Evelyn
Markdown

你有沒有在記事本軟體、GitHub 或部落格上,看過一串夾雜著 #、* 的奇怪文字?那個其實就是 Markdown,一種專門為寫作設計的輕量標記語法,它不像 HTML 那樣繁瑣,沒有程式背景也能看懂,只要記住幾個符號規則,就能快速排出標題、條列、粗體、連結等常見格式。接下來本文將從 Markdown 的起源說起,告訴你  Markdown 到底是什麼,為什麼連 AI 也使用這種語法。

Markdown 是什麼?

Markdown 誕生於 2004 年,由部落格《Daring Fireball》的創辦人約翰·格魯伯(John Gruber),與天才工程師艾倫·史瓦茲(Aaron Swartz)共同研發。在 2000 年代初期想在網路上發文,幾乎都得手動寫 HTML,光是發布一篇文章、要讓一段文字變粗體或加個連結,就得花費不少時間編寫原始碼,格魯伯想要的很單純:寫作的時候就專心寫作,排版的事讓工具來處理,Markdown 語法就是在這個想法下誕生的。

Markdown 是一種輕量級的「標記語法」,使用 #、*、-、[] 等純文字符號,快速為文字進行排版,當然功能豐富程度比不上傳統的 HTML 程式碼,但 Markdown 將複雜的網頁排版極簡化,讓寫作者完全不需要懂程式,就能產出結構完美的網頁內容。

Markdown vs HTML 比較表格

比較項目 Markdown HTML
定位 輕量級的「標記語言」,專為人類閱讀與寫作設計。 網頁的「骨架語言」,專為瀏覽器解析與渲染設計。
呈現方式 #、*、-、[]、() 等直覺符號 h1、p、strong 等成對的標籤
易讀性 高,即使不轉換成網頁,依然像普通純文字一樣好讀。 低,文字夾雜在大量標籤中,視覺上較為凌亂、不好閱讀。
排版自由度 有限,僅支援基礎的標題、清單、粗體、表格等樣式。 無限,可結合 CSS 進行複雜的排版、顏色調整與動態佈局。
運用場景 HackMD、GitHub、FB、部落格寫作、筆記軟體(Notion/Obsidian) 網頁開發、前端工程、需要精細設計的行銷活動落地頁(Landing Page)

(手機版表格可左右滑動)

Markdown 的 5 大優點

Markdown 優點 1. 好上手

Markdown 設計的出發點是「讓不懂寫程式的人也能用」,最常用的語法大概十個不到:「#」是標題、「**文字**」是粗體、「- 項目」是清單...等,很多人下午才接觸,隔天就可以開始用它寫筆記或文件,對沒有工程師背景的人來說是最容易上手的語法了。

Markdown 優點 2. 容易閱讀

隨便點開一般網站的原始碼,你會看到一堆標籤、文字夾雜一起,根本沒辦法閱讀,Markdown 就不一樣了,它的設計原則之一就是「原始文字也要能讀懂」,所以你不用任何工具輔助,就能直接理解這份文件在說什麼。

Markdown 優點 3. 普遍性高

到處都可以使用 Markdown 語法,例如:GitHub 的 README 檔案、Notion、Slack、Discord 打訊息時也能用部分 Markdown 語法讓文字加粗或斜體,連現在最紅的社群 Reddit、技術問答的 Stack Overflow,也都是用它來格式化貼文,也就是說學一套語法,換到大多數平台幾乎都能繼續使用,不用重新適應。

〈延伸閱讀:AI 時代 Reddit 很重要!平台介紹、B2B 實戰攻略看這篇!

Markdown 優點 4. 兼容HTML

Markdown 本身能做的是輕量文字排版處理,如果你想要更複雜的排版控制,例如:文字顏色、插入影片嵌入碼、特定對齊,在 Markdown 編輯器裡都允許你在文件中直接寫 HTML 標籤,兩者可以共存。

Markdown 優點 5. 萬年通用格式

Word 檔可能換個版本排版就會跑掉,或是用了某個 APP 記筆記,但後面要換 APP 資料會很難轉移。不過如果你是使用 Markdown 語法就不會有這個問題,Markdown 是純文字檔(通常檔案名為 .md 或 .txt),任何後台系統、文字編輯器都打得開,不存在版本相容的問題,過 50 年後再打開一樣沒問題。

Markdown 基礎語法教學

1. 段落標題

# 標題 1(H1)

## 標題 2(H2)

### 標題 3(H3)

 

標題 1(H1)

=============

標題 2(H2)

-------------

提醒:以上兩種方式都可以當作標題段落,不過標題需按照順序排列,從中跳過,容易破壞結構。

2. 字型(粗體/斜體)

**粗體文字**

*斜體文字*

***粗體加斜體***

提醒:除了多數人使用的*外,也可以用_來做標示(例如:_斜體文字_)。

3. 超連結

[連結文字](你的網址)

提醒:善用引導性文字,告訴讀者按下連結後將前往哪裡。

4. 圖片

![替代文字](圖片網址.png)

提醒:替代文字的用處是在圖片失效跑不出來時,幫助讀者/視障讀者能理解圖片的內容。

5. 項目清單

- 第一項

  - 第一項之1(內縮兩格)

  - 第一項之2(內縮兩格)

- 第二項

提醒:- 是大家最常使用的清單符號,不過 * 或 + 也都可以當作清單符號。

6. 表格

| 標題一 | 標題二 | 標題三 |

| --- | --- | --- |

| 項目 1 | 項目 2 | 項目 3 |

提醒:表格中的文字要對齊可參考下列語法,「:---」靠左對齊、「:---:」置中對齊、「---:」靠右對齊。

Markdown 進階語法與技巧

1. 引文

> 引文的第一個段落

>

> 引文的第二個段落

提醒:如果引文中包含多個段落,每個段落的開頭與段落間的空行均須加上大於號(>),確保整體格式呈現為完整的引文區塊。 

2.錨點連結

[連結文字](#哪個章節)

提醒:此方式是透過標題的錨點連結到同一份文件中的特定段落,實現頁面內的快速跳轉。

3.分隔線

***      * * *

---      - - -

___      _ _ _

提醒:以上3種符號都可以實現分隔線,中間也可以出現空格,但不能出現其他符號。

4.核取方塊

* [ ] 未完成的任務(無排序)

* [x] 完成的任務(無排序)

 

1. [ ] 未完成的任務(有排序)

2. [x] 完成的任務(有排序) 

提醒:代辦清單最適合用到核取方塊,在 Markdown 語法裡,x 代表已完成會顯示為打勾狀態,如果還要有排序,在前面加上數字即可。

5.跳脫 Markdown 語法顯示該符號

\ 符號

提醒:若想在 Markdown 語法中讓特殊符號當作一般字元,只要在前面加上反斜線(\)即可。

免費 Markdown 編輯器推薦

Visual Studio Code (VS code)

Markdown 編輯器推薦:VS code
  • 支援系統:Windows/macOS/Linux
  • 支援語言:多國語言介面(包含繁體中文)

Visual Studio Code 是由 Microsoft 開發的免費程式碼編輯器,支援多種作業系統,並提供 JavaScript、Python、C++、Java、Go …等數十種程式語言的支援,啟動速度快、記憶體佔用低,透過擴充市集還能安裝上千種插件來擴充功能。根據統計,全球有超過 75.9% 的開發者都以此為主力,VS Code 可以說是程式碼編輯器的第一首選。開啟編輯器

Dillinger

Markdown 編輯器推薦:Dillinger
  • 支援系統:網頁瀏覽器
  • 支援語言:英文介面

Dillinger 是一款免費線上 Markdown 編輯器,透過瀏覽器可直接使用,左側為編輯區、右側為即時預覽區,使用者在撰寫的同時能即時查看 Markdown、HTML 及 PDF 的呈現效果。如果你平常就有用 Dropbox、GitHub、Google Drive 和 OneDrive 來儲存檔案的習慣,你會很適合使用 Dillinger, Dillinger 的另一個特色就是支援這些雲端平台,在使用上非常方便。開啟編輯器

Zettlr

Markdown 編輯器推薦:Zettlr
  • 支援系統:Windows/macOS/Linux
  • 支援語言:多國語言

Zettlr 是 2017 年推出的免費開源 Markdown 編輯器,主要針對學術研究人員、學生和寫作者設計,資料全部存在本機端,不需要雲端同步,隱私和資料自主性都掌握在自己手上。在文獻管理方面,Zettlr 直接與 Zotero、BibTeX 搭配,可以在寫作途中插入引文或快速整理參考資料,寫完後也能直接匯出成 Word、HTML、PDF 這些常見文件格式。開啟編輯器

Obsidian

Markdown 編輯器推薦:Obsidian
  • 支援系統:Windows、macOS、Linux、iOS、Android
  • 支援語言:多國語言(含簡體中文)

Obsidian 是一款免費的 Markdown 筆記軟體,所有資料都存在自己電腦的硬碟裡,不用註冊帳號,也不需要連接任何雲端伺服器,資料完全掌握在自己手上。另外它的外掛生態也很豐富,社群開發的外掛超過 2,700 個,行事曆、心智圖、AI 整合這些功能都可以按自己的需求來安裝,客製化彈性相當高。 2026 年後 Obsidian 因純文字格式與 AI 工具的高度相容性而再度爆紅,成為許多使用者打造 AI 驅動個人知識庫的首選工具。開啟編輯器

Markdown 常見問題

Q1. Markdown 檔案要用什麼打開?

Markdown 的本質是純文字檔,所以大部分能讀取文字的程式都可以開啟它。最基本的記事本(Windows)或文字編輯器(macOS),雖然不會渲染格式,但內容完全可讀。

Q2. Markdown 可以轉為  PDF 檔嗎?

可以,要把 Markdown 轉成 PDF 通常有 4 種方式,最快的是用線上轉換工具,或是直接在瀏覽器選「列印」另存新檔,如果平時習慣用 VS Code,裝個擴充套件也能在編輯器內搞定,要是內容涉及更複雜的公式排版,那 Pandoc 會是更專業的選擇。

Q3. Markdown 與 HTML 有什麼不一樣?

都是用來標記文件格式的語言,但設計目標和使用情境不同。 HTML 用的是標籤語法,像 <h1>、<strong>、<a href=""> 這種寫法,功能很完整,但不好閱讀,比較常見於網頁開發。 Markdown 走的是另一個方向,用簡單的符號來代替標籤,# 就是標題、** 就是粗體、[文字](連結) 就是超連結,光看符號大概就能猜到意思,閱讀起來輕鬆很多。

Q4. 為什麼我用 Markdown 語法跑不出來?

標準 Markdown 定義了基本語法,但各平台幾乎都有自己的擴充版本,這些擴充版本通常叫做「方言」(Flavor),像 GitHub 用的是 GFM(GitHub Flavored Markdown),多了任務清單 - [ ]、表格這些功能,但不是每個平台都有跟進支援,所以同樣的 Markdown 語法,在不同平台上跑出來的效果不見得一樣,還是要看各平台自己的規定。

結論

在 AI 時代,Markdown 已經從單純的網頁文字排版工具,轉變為不可或缺的溝通媒介,這點從大型語言模型(LLM)採用 Markdown 就可以看出端倪,由於 HTML 標籤過於複雜,容易干擾 AI 的文本檢索,而 Markdown 則能直接提供乾淨的核心資訊,讓 AI 的回應更為精準。現在掌握 Markdown 早就不只是多學一種標記語言,而是讓你能在這個 AI 時代,建立一個更高效與 AI 溝通的方式。

〈延伸閱讀:LLMS.TXT 終極指南:你的網站需要一份「AI 說明書」

(本文為達文西數位科技所有,禁止轉載圖文)

喜歡探索最新的行銷手法,而SEO就是一種免費且穩定的行銷方式,希望通過創新易懂的方式為大家帶來全新的體驗和理解。

SEO套版網站,優惠$ NT 75,000 (1年代管+SSL)

請與我們聯繫