Markdown编辑器完全指南

2024年 阅读约 14 分钟 入门教程

全面学习Markdown语法和使用技巧,掌握标题、列表、代码块、表格等常用语法。附在线Markdown编辑器。

什么是Markdown

Markdown是一种轻量级标记语言,使用纯文本格式编写文档,通过简单的标记符号实现排版。它被广泛用于README、文档、博客等场景。

标题语法

使用#号表示标题,一个#是一级标题,两个##是二级标题,以此类推,最多六级。

# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
提示:# 与标题文字之间要有一个空格,这是最常见的书写错误。建议同一个文档标题层级连续使用,不要跳级。

文本格式

强调语法:一对星号是斜体,两对是粗体,三对是粗斜体;两个波浪号是删除线;反引号是行内代码。

*斜体* → <em>斜体</em> **粗体** → <strong>粗体</strong> ***粗斜体*** → <strong><em>粗斜体</em></strong> ~~删除线~~ → <del>删除线</del> `行内代码` → <code>行内代码</code>

列表与引用:无序列表用 - 或 *,有序列表用 数字加英文句点,嵌套缩进两个空格(或一个 Tab);引用用 > 开头,可多层嵌套。

- 无序列表项一 - 无序列表项二 - 嵌套子项(缩进两格) 1. 有序列表项一 2. 有序列表项二 > 一级引用 >> 二级引用

链接与图片:链接是 [文字](地址),图片在前面多一个感叹号,支持鼠标悬停标题。

[极品工具](https://jptool.cn "悬停提示") ![图片描述](https://jptool.cn/assets/og-image.jpg)

代码块

用三个反引号围栏包裹代码块,第一行末尾标注语言名可获得语法高亮;这是 Markdown 里使用频率最高的语法之一。

```js function hello() { console.log('Hello, Markdown!'); // js 高亮 } ```
注意:反引号必须是英文半角字符;代码块内的内容不会被 Markdown 解析,HTML 标签也无需转义,直接粘贴即可。

缩进式代码块:每行缩进 4 个空格也能形成代码块,但不支持语法高亮,现在更推荐围栏写法。

表格

表格用竖线分隔单元格,用第二行的连字符与冒号控制对齐方式:默认左对齐,:--: 居中,--: 右对齐。

| 工具 | 用途 | 收费 | |------|:----:|-----:| | JSON格式化 | 格式化校验 | 免费 | | 正则测试 | 在线调试 | 免费 |
提示:单元格内不能直接换行;竖线会破坏表格结构,需要用 | 转义。GitHub 风格 Markdown 还支持在单元格里写行内代码和链接。

使用技巧

转义字符:想显示 Markdown 语法本身(比如写教程),在符号前加反斜杠即可:\*、\#、\[。

任务列表:GFM 扩展语法,GitHub、语雀等平台都支持,适合写 TODO 和更新日志。

- [x] 已完成:搭建站点 - [ ] 进行中:补充教程 - [ ] 待办:SEO 优化

分隔线与脚注:三个以上的星号、连字符或下划线独占一行是分隔线;脚注用 [^1] 标注、文末补充说明,适合论文式写作。

最佳实践:① 标题层级不要跳级,一篇文档一个 h1;② 列表前后留空行,避免解析成普通段落;③ 复杂表格在编辑器里调,别手写对齐;④ 不同平台对语法的支持有差异(如 GFM 才支持表格和任务列表),跨平台发布前先预览。

本站的 Markdown 编辑器支持实时预览和一键复制,可以边写边对照效果。