"Word 太重、格式不通用；纯文本又没有排版。我想要一种轻量的写作格式，用纯文本就能实现标题、列表、代码高亮——但 Markdown 的语法我不太熟。"
Suried Markdown 编辑器提供实时预览——左边写 Markdown 语法，右边即时看到排版效果。本篇教程带你从第一个标题开始，10 分钟掌握所有常用 Markdown 语法。
01 什么是 Markdown？
Markdown 是一种轻量级标记语言，由 John Gruber 在 2004 年创建。它的核心理念是：用纯文本书写，通过简单符号（如 # 表示标题、** 表示粗体）实现格式化，可读性极强——即使不渲染也能清楚地看懂内容结构。
Markdown 已成为技术写作的事实标准——GitHub README、技术博客、API 文档、笔记应用（Notion、Obsidian）都使用 Markdown。学会 Markdown 就掌握了一种通用的写作语言。
与 Word/Pages 等富文本编辑器不同，Markdown 文件是纯文本格式（.md），文件体积极小、跨平台兼容、版本控制友好、永远不会出现格式混乱。
02 基础语法：标题、粗体、斜体
标题使用 # 号标记。# 一级标题（最大）、## 二级标题、### 三级标题，以此类推到 ###### 六级标题。# 和文字之间需要一个空格。
粗体使用双星号包裹：**粗体文字**。斜体使用单星号：*斜体文字*。粗斜体使用三星号：***粗斜体***。也可以用下划线替代星号：__粗体__、_斜体_，但社区更推荐星号写法。
删除线使用双波浪线：~~已删除的文字~~。行内代码使用反引号包裹：`console.log()`。这两种标记在技术文档中经常使用。
在 Suried 编辑器中，快捷键 Ctrl+B 切换粗体、Ctrl+I 切换斜体，让你不用记语法也能快速格式化。
03 链接与图片
链接语法：[显示文字](URL)。例如 [Google](https://google.com) 会渲染为可点击的超链接。可以在 URL 后添加标题：[Google](https://google.com "搜索引擎")。
图片语法与链接类似，只是前面加一个感叹号：。例如 。替代文字用于图片无法加载时的替代显示和无障碍访问。
引用链接适合在文中多次引用同一链接：先定义 [网站名]: URL，再用 [显示文字][网站名] 引用。这让长文档的链接管理更整洁。
04 代码块
行内代码用单个反引号包裹：`const x = 1`。多行代码块使用三个反引号围栏，在开头反引号后指定语言以启用语法高亮：
支持的语言标记包括：javascript / js、typescript / ts、python、html、css、json、bash / sh、sql 等。Suried 编辑器支持大量编程语言的语法着色。
如果你的代码中包含反引号，可以用双反引号包裹行内代码：``code with `backtick` ``。代码块内的所有内容都是按原样显示的，不会被 Markdown 渲染。
05 列表与表格
无序列表使用 -、* 或 + 开头（推荐用 -）。有序列表使用数字加点号：1.、2.、3.。嵌套列表通过缩进（2或4个空格）实现。
任务列表（TODO List）使用 - [ ] 未完成、- [x] 已完成。这在 GitHub Issues 和项目管理文档中非常实用。Suried 编辑器会将它们渲染为可交互的复选框。
表格使用管道符 | 分隔列，使用 --- 分隔表头和内容行。对齐方式通过冒号控制：:--- 左对齐、:---: 居中、---: 右对齐。虽然 Markdown 表格语法比较繁琐，但 Suried 编辑器会实时渲染让你确认效果。
Markdown 表格不擅长复杂表格（如合并单元格）。如果需要复杂表格，建议直接使用 HTML <table> 标签——Markdown 支持内嵌 HTML。
常见问题
Markdown 和 HTML 有什么关系？
Markdown 本质上会被转换成 HTML 来渲染。# 标题 变成 <h1>标题</h1>，**粗体** 变成 <strong>粗体</strong>。Markdown 是 HTML 的简化写法，而且 Markdown 文件中可以直接嵌入 HTML 标签。
Suried Markdown 编辑器支持数学公式吗？
支持 KaTeX / LaTeX 数学公式语法。行内公式用 $ 包裹：$E = mc^2$。独立公式块用 $$ 包裹。适合撰写技术文档和学术笔记。
不同平台的 Markdown 语法完全相同吗？
基础语法（标题、粗体、列表等）在所有平台上一致。但各平台有自己的扩展——GitHub Flavored Markdown (GFM) 添加了任务列表、表格、删除线等；CommonMark 是标准化规范。Suried 编辑器兼容 GFM。
Markdown 中如何换行？
在 Markdown 中，单纯按一次 Enter 不会产生换行——需要在行末加两个空格再换行（硬换行），或者空一行来创建新段落。这是 Markdown 最容易让新手困惑的设计之一。Suried 编辑器的实时预览会清楚地展示换行效果。
可以用 Markdown 写书籍或长文档吗？
完全可以！很多技术书籍就是用 Markdown 编写的（如 Gitbook、mdBook）。Markdown 配合目录生成器、交叉引用和导出工具，完全能胜任长文档写作。Suried 编辑器的导出功能可以将 Markdown 转为美观的 HTML 或直接下载 .md 文件。
立即使用工具
Suried Markdown 编辑器提供实时预览——左边写 Markdown 语法，右边即时看到排版效果。本篇教程带你从第一个标题开始，10 分钟掌握所有常用 Markdown 语法。