[{"data":1,"prerenderedAt":271},["ShallowReactive",2],{"wiki-page-\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":3,"wiki-doc-items-\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":236,"language-switcher-data-\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":255,"wiki-i18n-paths-\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":270},{"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":230,"locale":231,"localeSlug":232,"meta":233,"navigation":228,"path":217,"seo":234,"sourcePath":230,"sourceStem":226,"stem":226,"wikiDepth":91,"__hash__":235},"content\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-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie",0,"0100","2025-12-25","wiki\u002F2025-12-25-markdown-jiao-cheng","zh-cn:2025-12-25-markdown-jiao-cheng","\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng","MarkDown教程","md","wiki\u002F2025-12-25-MarkDown教程\u002F0100-简介",false,true,null,"\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-CN","zh-cn",{},{"title":5,"description":16},"qqSTUGh8BxQGmefaLzqryzKfiOF6_jD3cFyAklg90Zw",[237,238,243,248,253],{"path":217,"stem":226,"title":5,"date":220,"chapterOrder":219,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},{"path":239,"stem":240,"title":241,"date":220,"chapterOrder":242,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},"\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","wiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建","环境搭建","0200",{"path":244,"stem":245,"title":246,"date":220,"chapterOrder":247,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},"\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0300-jiao-xue","wiki\u002F2025-12-25-MarkDown教程\u002F0300-教学","教学","0300",{"path":249,"stem":250,"title":251,"date":220,"chapterOrder":252,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":227},"\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0400-gao-ji-ji-qiao","wiki\u002F2025-12-25-MarkDown教程\u002F0400-高级技巧","高级技巧","0400",{"path":223,"stem":254,"title":224,"date":220,"chapterOrder":229,"chapterDepth":218,"docKey":222,"docRoot":223,"docTitle":224,"isWikiDoc":228,"isWikiIndex":228},"wiki\u002F2025-12-25-MarkDown教程\u002Findex",{"variants":256},[257,260,263,266,269],{"path":258,"localeSlug":259,"i18nKey":226},"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","en-us",{"path":261,"localeSlug":262,"i18nKey":226},"\u002Fzh-hant\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-hant",{"path":264,"localeSlug":265,"i18nKey":226},"\u002Fzh-hk\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-hk",{"path":267,"localeSlug":268,"i18nKey":226},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-tw",{"path":217,"localeSlug":232,"i18nKey":226},[258,230,261,230,264,230,267,230,217,230],1788531240700]