Markdown 文件 (.md)
CommonMark 標準Markdown (MD) 是全球最熱門的輕量級標記語言，由 John Gruber 所設計，旨在讓純文字易於閱讀與編寫，同時能乾淨地轉換為結構化的 HTML。
檢查與中繼資料
作業系統與檔案分析工具透過檢查開頭的二進位位元組序列來識別 Markdown 檔案：
位元組層級標頭簽章（檔案簽章）
作業系統與檔案分析工具透過檢查開頭的二進位位元組序列來識別 Markdown 檔案：
十六進位簽章（偏移量 0）：
無固定簽章（Markdown 為純文字）ASCII 表示法： 無固定 ASCII 簽章
標準化： CommonMark 規格 / GitHub Flavored Markdown (GFM)
技術規格
| 容器架構 | 採用輕量級標點符號格式（標題、清單、粗體、斜體、程式碼區塊）的純 UTF-8 文字檔案 |
| 壓縮 | 未壓縮文字（可輕易使用 Gzip 或 Brotli 進行壓縮） |
| 位元組序 | UTF-8 / Unicode 文字串流 |
| 色彩空間 | 不適用（純文字標記） |
| 色版與結構 | 標題、引用、無序／有序清單、程式碼圍欄、超連結、圖片與表格 |
| 最大尺寸 | 無限制的文字文件長度 |
| 透明度 | 無（純文字） |
| 串流與漸進式 | 串流逐行區塊與行內符號化 |
技術比較矩陣：Markdown 對比競爭格式
| 技術屬性 | Markdown (目前) | HTML | TXT | |
|---|---|---|---|---|
| 編寫簡便性 | 極快的純文字輸入 | 冗長的標籤語法（<p>、<div>） | 快速輸入（無格式） | 需要圖形版面編輯器 |
| 人類可讀性（原始狀態） | 極致的自然文字可讀性 | 被標籤與括號干擾 | 極致的文字可讀性 | 二進位無法讀取的原始位元組 |
| HTML 轉換 | 直接 1 對 1 的確定性輸出 | 原生網頁語言 | 需要手動排版 | 固定的圖形輸出 |
| 開發人員工具 | 支援程度因軟體而異。 | 支援程度因軟體而異。 | 支援程度因軟體而異。 | 文件發布 |
常見損壞模式與十六進位修復指南
程式碼區塊會被算繪為一般段落，或者標題無法正確排版。
根本原因: 標題的「#」符號後方缺少空格，或是三反勾號（```）程式碼包覆區塊未正確關閉。
修復: 使用 File2File.app Markdown 檢查工具驗證並重新排版 Markdown 語法。
安全性分析與解析器攻擊向量
Markdown 轉換器通常預設允許原始內嵌 HTML，若未進行清理可能會導致跨網站指令碼攻擊（XSS）。
已知攻擊向量
- 透過內嵌在 Markdown 文字中的原始 HTML 元素（例如 '<script>' 或 '<img onerror=...>'）進行 XSS 注入。
- 透過不符合規範的剖析器中巢狀過深的引用區塊或清單結構，導致阻斷服務攻擊。
- Markdown 連結語法內含惡意的連結協定（「javascript:」）。
防禦最佳實務: 務必使用 DOMPurify 清理產生的 HTML 輸出，並禁止不安全的 URL 通訊協定。
歷史起源與里程碑
2017GitHub Flavored Markdown (GFM) 根據正式的 CommonMark 規格進行標準化。
2014由 Jeff Atwood 與 John MacFarlane 發起 CommonMark 計畫，以標準化模稜兩可的 Markdown 邊緣案例。
2004John Gruber 與 Aaron Swartz 發布原始的 Markdown 1.0 規格與 Perl 轉換程式碼。
主要優勢與優點
- 極佳的人類可讀性：即使在基本終端機或純文字編輯器中檢視，格式化文字看起來依然乾淨且自然。
- Markdown 在說明文件中很常見，但語法與算繪方式會因工具而異。
- 零廠商鎖定：純文字檔案在沒有專屬檢視軟體的情況下，也能維持數百年可讀性。
技術限制與缺點
- 2004 年的原始規格具有模稜兩可的剖析規則，導致細微的方言分歧（CommonMark、GFM、Kramdown）。
- 原生不支援複雜的頁面版面功能，例如多欄雜誌版面、文字繞排或頁碼。
- 嵌入的圖片是從外部連結，而不是儲存在文件檔案內部。
有趣的技術冷知識
- 17 歲時與 John Gruber 共同開發 Markdown 的 Aaron Swartz，也是 Reddit 的共同創辦人並建構了 RSS 1.0。
- 許多 GitHub 儲存庫使用 README.md 檔案來介紹專案，不過儲存庫也可以使用其他名稱或省略。
- Markdown 設計理念指出：「Markdown 格式語法的主要設計目標，是使其盡可能具有可讀性。」
常見技術問題
Markdown 的用途是什麼？
Markdown 用於編寫說明文件、GitHub README 檔案、部落格文章、在 Obsidian 和 Notion 等應用程式中記筆記，以及在 Discord 和 Slack 等平台上撰寫訊息。
如何將 Markdown 轉換為 PDF 或 HTML？
您可以直接在網頁瀏覽器中使用 File2File.app，一鍵將 Markdown（.md）檔案轉換為具備樣式的 PDF 文件或乾淨的 HTML 程式碼。
什麼是 GitHub 風格的 Markdown（GFM）？
GFM 是 GitHub 擴充版本的 Markdown，增加了對表格、帶有核取方塊的待辦清單（[x]）、刪除線（~~text~~）以及具備語法突顯功能的程式碼區塊的支援。