[{"data":1,"prerenderedAt":297},["ShallowReactive",2],{"wiki-page-\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":3,"wiki-doc-items-\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":261,"language-switcher-data-\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":281,"wiki-i18n-paths-\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie":296},{"id":4,"title":5,"body":6,"canonicalPath":241,"chapterDepth":242,"chapterOrder":243,"date":244,"description":16,"docI18nKey":245,"docKey":246,"docRoot":247,"docTitle":248,"extension":249,"i18nKey":250,"isBlogPost":251,"isWikiDoc":252,"isWikiIndex":251,"layout":253,"legacyPath":253,"locale":254,"localeSlug":255,"meta":256,"navigation":252,"path":241,"seo":257,"sourcePath":258,"sourceStem":250,"stem":259,"wikiDepth":100,"__hash__":260},"content\u002F_i18n\u002Fen-us\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0100-简介.md","Introduction",{"type":7,"value":8,"toc":238},"minimark",[9,13,17,20,23,26,29,32,35,38,41,44,47,50,53,56,59,62,65,68,72,75,86,89,103,106,130,133,137,140,143,146,149,152,156,159,162,165,168,171,174,177,180,183,186,189,192,195,198,201,204,207,210,213,216,219,222,225,228,231,234],[10,11,5],"h1",{"id":12},"introduction",[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],{},"学习成本低，几分钟就能掌握基本语法",[14,60,61],{},"编写效率高，无需输入复杂的标签",[14,63,64],{},"专注内容，而非格式细节",[14,66,67],{},"版本控制友好，便于协作和变更追踪",[10,69,71],{"id":70},"markdown-与-html-的关系","Markdown 与 HTML 的关系",[14,73,74],{},"Markdown 并不是 HTML 的替代品，而是 HTML 的简化版本。实际上，Markdown 的最终目标就是转换为 HTML。两者的关系可以这样理解：",[76,77,83],"pre",{"className":78,"code":80,"language":81,"meta":82},[79],"language-text","Markdown 源码 → 解析器 → HTML 输出 → 浏览器渲染\n","text","",[84,85,80],"code",{"__ignoreMap":82},[14,87,88],{},"例如，当你写下：",[76,90,94],{"className":91,"code":92,"language":93,"meta":82,"style":82},"language-markdown shiki shiki-themes github-light github-dark","# 这是一个标题\n","markdown",[84,95,96],{"__ignoreMap":82},[97,98,101],"span",{"class":99,"line":100},"line",1,[97,102,92],{},[14,104,105],{},"它会被转换为：",[76,107,111],{"className":108,"code":109,"language":110,"meta":82,"style":82},"language-html shiki shiki-themes github-light github-dark","\u003Ch1>这是一个标题\u003C\u002Fh1>\n","html",[84,112,113],{"__ignoreMap":82},[97,114,115,119,122,125,127],{"class":99,"line":100},[97,116,118],{"class":117},"sVt8B","\u003C",[97,120,10],{"class":121},"s9eBZ",[97,123,124],{"class":117},">这是一个标题\u003C\u002F",[97,126,10],{"class":121},[97,128,129],{"class":117},">\n",[14,131,132],{},"重要的是，在 Markdown 中你可以直接使用 HTML 标签，这为复杂格式提供了灵活性。当 Markdown 的基础语法无法满足需求时，可以嵌入 HTML 代码来实现特定效果。",[10,134,136],{"id":135},"为什么选择-markdown","为什么选择 Markdown",[14,138,139],{},"提高写作效率：无需频繁使用鼠标进行格式设置，可以保持思路的连贯性。写作者可以专注于内容创作，而不被格式问题分散注意力。",[14,141,142],{},"降低学习门槛：相比于 LaTeX、HTML 等标记语言，Markdown 的语法极其简单，大多数人可以在一小时内掌握基本用法。",[14,144,145],{},"广泛兼容性：几乎所有的现代文本编辑器、代码编辑器、笔记应用都支持 Markdown。从简单的记事本到专业的 IDE，你都能找到 Markdown 的身影。",[14,147,148],{},"版本控制友好：由于是纯文本格式，Markdown 文件可以很好地与 Git 等版本控制系统配合，便于追踪文档的修改历史和团队协作。",[14,150,151],{},"未来适应性：即使特定的软件或平台消失，Markdown 文件作为纯文本仍然可以被访问和编辑，确保了内容的长期可用性。",[10,153,155],{"id":154},"markdown-的应用场景","Markdown 的应用场景",[14,157,158],{},"技术文档编写",[14,160,161],{},"在软件开发领域，Markdown 已成为技术文档的标准格式。它特别适合：",[14,163,164],{},"API 文档：清晰的标题层次和代码块展示，让 API 说明既专业又易读。许多 API 文档生成工具（如 Swagger）都支持 Markdown 格式的描述。",[14,166,167],{},"项目说明：从安装指南到使用手册，Markdown 能够有效组织技术信息。代码示例、配置文件、命令行操作都能得到恰当的展示。",[14,169,170],{},"开发规范：团队的编码规范、设计准则、工作流程等都可以用 Markdown 编写，方便团队成员查阅和更新。",[14,172,173],{},"博客文章创作",[14,175,176],{},"现代的博客平台和静态网站生成器大多支持 Markdown：",[14,178,179],{},"内容管理：博主可以专注于内容创作，而不必担心复杂的 HTML 编码。文章的格式化通过简单的标记即可完成。",[14,181,182],{},"平台迁移：使用 Markdown 编写的文章可以轻松在不同平台间迁移，不会因为平台特有的格式而被锁定。",[14,184,185],{},"离线编写：可以在任何文本编辑器中离线编写文章，然后批量发布，提高了写作的灵活性。",[14,187,188],{},"GitHub README 文件",[14,190,191],{},"GitHub 平台广泛使用 Markdown，特别是项目的 README 文件：",[14,193,194],{},"项目介绍：清晰展示项目的目的、特性、使用方法等关键信息。",[14,196,197],{},"安装指南：通过代码块和列表，提供详细的安装和配置步骤。",[14,199,200],{},"贡献指南：说明如何参与项目开发，包括代码规范、提交流程等。",[14,202,203],{},"问题跟踪：在 Issues 和 Pull Requests 中，开发者使用 Markdown 来描述问题、提供解决方案。",[14,205,206],{},"笔记记录和知识管理",[14,208,209],{},"Markdown 正成为数字笔记的首选格式：",[14,211,212],{},"学习笔记：支持数学公式、代码高亮、图表等多种内容类型，适合技术学习和知识整理。",[14,214,215],{},"会议记录：清晰的标题结构和列表格式，让会议要点一目了然。",[14,217,218],{},"知识库建设：企业和个人都在使用 Markdown 构建知识库，通过链接和标签组织信息。",[14,220,221],{},"在线写作平台",[14,223,224],{},"越来越多的写作平台开始支持 Markdown：",[14,226,227],{},"GitHub、简书、知乎：这些平台的编辑器支持 Markdown 语法，让创作者能够快速格式化文章。",[14,229,230],{},"GitBook、Notion：专业的文档和笔记平台，原生支持 Markdown，提供强大的组织和协作功能。",[14,232,233],{},"静态博客生成器：Nuxt content、Jekyll、Hugo、Hexo等工具让用户能够用 Markdown 创建专业的网站。",[235,236,237],"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":82,"searchDepth":239,"depth":239,"links":240},2,[],"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie",0,"0100","2025-12-25","wiki\u002F2025-12-25-markdown-jiao-cheng","en-us:2025-12-25-markdown-jiao-cheng","\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng","MarkDown教程","md","wiki\u002F2025-12-25-MarkDown教程\u002F0100-简介",false,true,null,"en-US","en-us",{},{"title":5,"description":16},"\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","_i18n\u002Fen-us\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0100-简介","vDFOzDF4MJ3WY3Kh2gYwBcYriSDBD2MOfkdLXH-ypEY",[262,263,268,273,278],{"path":241,"stem":259,"title":5,"date":244,"chapterOrder":243,"chapterDepth":242,"docKey":246,"docRoot":247,"docTitle":248,"isWikiDoc":252,"isWikiIndex":251},{"path":264,"stem":265,"title":266,"date":244,"chapterOrder":267,"chapterDepth":242,"docKey":246,"docRoot":247,"docTitle":248,"isWikiDoc":252,"isWikiIndex":251},"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","_i18n\u002Fen-us\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建","Environment Setup","0200",{"path":269,"stem":270,"title":271,"date":244,"chapterOrder":272,"chapterDepth":242,"docKey":246,"docRoot":247,"docTitle":248,"isWikiDoc":252,"isWikiIndex":251},"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0300-jiao-xue","_i18n\u002Fen-us\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0300-教学","teaching","0300",{"path":274,"stem":275,"title":276,"date":244,"chapterOrder":277,"chapterDepth":242,"docKey":246,"docRoot":247,"docTitle":248,"isWikiDoc":252,"isWikiIndex":251},"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0400-gao-ji-ji-qiao","_i18n\u002Fen-us\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0400-高级技巧","高级技巧","0400",{"path":247,"stem":279,"title":280,"date":244,"chapterOrder":253,"chapterDepth":242,"docKey":246,"docRoot":247,"docTitle":248,"isWikiDoc":252,"isWikiIndex":252},"_i18n\u002Fen-us\u002Fwiki\u002F2025-12-25-MarkDown教程\u002Findex","Markdown tutorial",{"variants":282},[283,284,287,290,293],{"path":241,"localeSlug":255,"i18nKey":250},{"path":285,"localeSlug":286,"i18nKey":250},"\u002Fzh-hant\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-hant",{"path":288,"localeSlug":289,"i18nKey":250},"\u002Fzh-hk\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-hk",{"path":291,"localeSlug":292,"i18nKey":250},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-tw",{"path":294,"localeSlug":295,"i18nKey":250},"\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","zh-cn",[241,258,285,258,288,258,291,258,294,258],1788531255546]