[{"data":1,"prerenderedAt":272},["ShallowReactive",2],{"wiki-page-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":3,"wiki-doc-items-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":237,"language-switcher-data-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":256,"wiki-i18n-paths-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":271},{"id":4,"title":5,"body":6,"canonicalPath":217,"chapterDepth":218,"chapterOrder":219,"date":220,"description":16,"docI18nKey":221,"docKey":222,"docRoot":223,"docTitle":224,"extension":225,"i18nKey":226,"isBlogPost":227,"isWikiDoc":228,"isWikiIndex":227,"layout":229,"legacyPath":229,"locale":230,"localeSlug":231,"meta":232,"navigation":228,"path":217,"seo":233,"sourcePath":234,"sourceStem":226,"stem":235,"wikiDepth":91,"__hash__":236},"content\u002F_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0100-简介.md","簡介",{"type":7,"value":8,"toc":214},"minimark",[9,13,17,20,23,26,29,32,35,38,41,44,47,50,53,56,59,63,66,77,80,94,97,121,124,128,131,134,137,140,143,147,150,153,156,159,162,165,168,171,174,177,180,183,186,189,192,195,198,201,204,207,210],[10,11,12],"h1",{"id":12},"介紹",[14,15,16],"p",{},"Markdown 是一種輕量級標記語言，它允許人們使用易讀易寫的純文本格式編寫文檔。",[14,18,19],{},"Markdown 語言在 2004 由約翰·格魯伯（英語：John Gruber）創建。",[14,21,22],{},"Markdown 的設計理念是\"易讀易寫\"，讓人們能夠使用簡單的純文本格式來編寫結構化文檔。",[14,24,25],{},"Markdown 編寫的文檔可以導出 HTML 、Word、圖像、PDF、Epub 等多種格式的文檔。",[14,27,28],{},"Markdown 編寫的文檔後綴為 .md, .markdown。",[10,30,31],{"id":31},"核心特點",[14,33,34],{},"Markdown 的核心特點包括：",[14,36,37],{},"簡潔性：使用直觀的符號來表示格式，比如用 # 表示標題，用 * 表示列表項。這些符號在視覺上就能傳達其含義，即使不進行渲染也具有良好的可讀性。",[14,39,40],{},"可讀性：即使是純文本形式的 Markdown 文檔，也能清晰地展現文檔的結構和層次。讀者無需專門的軟件就能理解內容的組織方式。",[14,42,43],{},"便攜性：Markdown 文件是純文本格式，可以在任何文本編輯器中打開和編輯，不依賴特定的軟件或操作系統。",[14,45,46],{},"轉換性：可以輕鬆轉換為 HTML、PDF、Word 文檔等多種格式，滿足不同的發佈需求。",[10,48,49],{"id":49},"輕量級標記語言的概念",[14,51,52],{},"標記語言是一種用特定符號來描述文檔結構和格式的語言。傳統的標記語言如 HTML 功能強大但語法複雜，而輕量級標記語言則簡化了這一過程。",[14,54,55],{},"與 HTML 相比，Markdown 的優勢在於：",[14,57,58],{},"學習成本低，幾分鐘就能掌握基本語法\n編寫效率高，無需輸入複雜的標籤\n專注內容，而非格式細節\n版本控制友好，便於協作和變更追蹤",[10,60,62],{"id":61},"markdown-與-html-的關係","Markdown 與 HTML 的關係",[14,64,65],{},"Markdown 並不是 HTML 的替代品，而是 HTML 的簡化版本。實際上，Markdown 的最終目標就是轉換為 HTML。兩者的關係可以這樣理解：",[67,68,74],"pre",{"className":69,"code":71,"language":72,"meta":73},[70],"language-text","Markdown 源码 → 解析器 → HTML 输出 → 浏览器渲染\n","text","",[75,76,71],"code",{"__ignoreMap":73},[14,78,79],{},"例如，當你寫下：",[67,81,85],{"className":82,"code":83,"language":84,"meta":73,"style":73},"language-markdown shiki shiki-themes github-light github-dark","# 这是一个标题\n","markdown",[75,86,87],{"__ignoreMap":73},[88,89,92],"span",{"class":90,"line":91},"line",1,[88,93,83],{},[14,95,96],{},"它會被轉換為：",[67,98,102],{"className":99,"code":100,"language":101,"meta":73,"style":73},"language-html shiki shiki-themes github-light github-dark","\u003Ch1>这是一个标题\u003C\u002Fh1>\n","html",[75,103,104],{"__ignoreMap":73},[88,105,106,110,113,116,118],{"class":90,"line":91},[88,107,109],{"class":108},"sVt8B","\u003C",[88,111,10],{"class":112},"s9eBZ",[88,114,115],{"class":108},">这是一个标题\u003C\u002F",[88,117,10],{"class":112},[88,119,120],{"class":108},">\n",[14,122,123],{},"重要的是，在 Markdown 中你可以直接使用 HTML 標籤，這為複雜格式提供了靈活性。當 Markdown 的基礎語法無法滿足需求時，可以嵌入 HTML 代碼來實現特定效果。",[10,125,127],{"id":126},"為什麼選擇-markdown","為什麼選擇 Markdown",[14,129,130],{},"提高寫作效率：無需頻繁使用鼠標進行格式設置，可以保持思路的連貫性。寫作者可以專注於內容創作，而不被格式問題分散注意力。",[14,132,133],{},"降低學習門檻：相比於 LaTeX、HTML 等標記語言，Markdown 的語法極其簡單，大多數人可以在一小時內掌握基本用法。",[14,135,136],{},"廣泛兼容性：幾乎所有的現代文本編輯器、代碼編輯器、筆記應用都支持 Markdown。從簡單的記事本到專業的 IDE，你都能找到 Markdown 的身影。",[14,138,139],{},"版本控制友好：由於是純文本格式，Markdown 文件可以很好地與 Git 等版本控制系統配合，便於追蹤文檔的修改歷史和團隊協作。",[14,141,142],{},"未來適應性：即使特定的軟件或平臺消失，Markdown 文件作為純文本仍然可以被訪問和編輯，確保了內容的長期可用性。",[10,144,146],{"id":145},"markdown-的應用場景","Markdown 的應用場景",[14,148,149],{},"技術文檔編寫\n在軟件開發領域，Markdown 已成為技術文檔的標準格式。它特別適合：",[14,151,152],{},"API 文檔：清晰的標題層次和代碼塊展示，讓 API 說明既專業又易讀。許多 API 文檔生成工具（如 Swagger）都支持 Markdown 格式的描述。",[14,154,155],{},"項目說明：從安裝指南到使用手冊，Markdown 能夠有效組織技術信息。代碼示例、配置文件、命令行操作都能得到恰當的展示。",[14,157,158],{},"開發規範：團隊的編碼規範、設計準則、工作流程等都可以用 Markdown 編寫，方便團隊成員查閱和更新。",[14,160,161],{},"博客文章創作\n現代的博客平臺和靜態網站生成器大多支持 Markdown：",[14,163,164],{},"內容管理：博主可以專注於內容創作，而不必擔心複雜的 HTML 編碼。文章的格式化通過簡單的標記即可完成。",[14,166,167],{},"平臺遷移：使用 Markdown 編寫的文章可以輕鬆在不同平臺間遷移，不會因為平臺特有的格式而被鎖定。",[14,169,170],{},"離線編寫：可以在任何文本編輯器中離線編寫文章，然後批量發佈，提高了寫作的靈活性。",[14,172,173],{},"GitHub README 文件\nGitHub 平臺廣泛使用 Markdown，特別是項目的 README 文件：",[14,175,176],{},"項目介紹：清晰展示項目的目的、特性、使用方法等關鍵信息。",[14,178,179],{},"安裝指南：通過代碼塊和列表，提供詳細的安裝和配置步驟。",[14,181,182],{},"貢獻指南：說明如何參與項目開發，包括代碼規範、提交流程等。",[14,184,185],{},"問題跟蹤：在 Issues 和 Pull Requests 中，開發者使用 Markdown 來描述問題、提供解決方案。",[14,187,188],{},"筆記記錄和知識管理\nMarkdown 正成為數字筆記的首選格式：",[14,190,191],{},"學習筆記：支持數學公式、代碼高亮、圖表等多種內容類型，適合技術學習和知識整理。",[14,193,194],{},"會議記錄：清晰的標題結構和列表格式，讓會議要點一目瞭然。",[14,196,197],{},"知識庫建設：企業和個人都在使用 Markdown 構建知識庫，通過鏈接和標籤組織信息。",[14,199,200],{},"在線寫作平臺\n越來越多的寫作平臺開始支持 Markdown：",[14,202,203],{},"GitHub、簡書、知乎：這些平臺的編輯器支持 Markdown 語法，讓創作者能夠快速格式化文章。",[14,205,206],{},"GitBook、Notion：專業的文檔和筆記平臺，原生支持 Markdown，提供強大的組織和協作功能。",[14,208,209],{},"靜態博客生成器：Nuxt content、Jekyll、Hugo、Hexo等工具讓用戶能夠用 Markdown 創建專業的網站。",[211,212,213],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}",{"title":73,"searchDepth":215,"depth":215,"links":216},2,[],"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie",0,"0100","2025-12-25","wiki\u002F2025-12-25-markdown-jiao-cheng","zh-tw:2025-12-25-markdown-jiao-cheng","\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng","MarkDown教程","md","wiki\u002F2025-12-25-MarkDown教程\u002F0100-简介",false,true,null,"zh-TW","zh-tw",{},{"title":5,"description":16},"\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0100-简介","RnWhxcNhCb-ERYiBZubH5hDWkPaGPdOBFOmg8_HJcbk",[238,239,244,249,254],{"path":217,"stem":235,"title":5,"date":220,"chapterOrder":219,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},{"path":240,"stem":241,"title":242,"date":220,"chapterOrder":243,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建","環境搭建","0200",{"path":245,"stem":246,"title":247,"date":220,"chapterOrder":248,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0300-jiao-xue","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0300-教学","教學","0300",{"path":250,"stem":251,"title":252,"date":220,"chapterOrder":253,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0400-gao-ji-ji-qiao","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0400-高级技巧","高級技巧","0400",{"path":223,"stem":255,"title":224,"date":220,"chapterOrder":229,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":228},"_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002Findex",{"variants":257},[258,261,264,267,268],{"path":259,"localeSlug":260,"i18nKey":226},"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","en-us",{"path":262,"localeSlug":263,"i18nKey":226},"\u002Fzh-hant\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-hant",{"path":265,"localeSlug":266,"i18nKey":226},"\u002Fzh-hk\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-hk",{"path":217,"localeSlug":231,"i18nKey":226},{"path":269,"localeSlug":270,"i18nKey":226},"\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-cn",[259,234,262,234,265,234,217,234,269,234],1788531253086]