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