1330 字
7 分钟
正在加载...
Markdown 基础语法指南

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。本文将详细介绍 Markdown 的基础语法,帮助初学者快速掌握这个强大的文档编写工具。
什么是 Markdown?
Markdown 由 John Gruber 在 2004 年创建,目标是让人们能够使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML。它的语法简洁明了,学习成本低,被广泛应用于:
- 技术文档编写
- 博客文章
- README 文件
- 在线论坛
- 笔记应用
基础语法
标题语法
Markdown 支持六级标题,使用 #
符号表示:
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题
效果展示:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
文本格式
基础文本样式
语法 | 效果 | 说明 |
---|---|---|
**粗体文本** | 粗体文本 | 使用两个星号包围 |
*斜体文本* | 斜体文本 | 使用一个星号包围 |
***粗斜体*** | 粗斜体 | 使用三个星号包围 |
~~删除线~~ | 使用两个波浪号包围 |
替代语法
你也可以使用下划线来表示强调:
__粗体文本___斜体文本____粗斜体___
段落和换行
- 段落:段落之间用空行分隔
- 换行:行末加两个空格,或使用
<br>
标签
这是第一段文字。
这是第二段文字。
这是同一段的第一行。这是同一段的第二行。
链接语法
行内链接
[链接文本](https://example.com)[带标题的链接](https://example.com "这是标题")
效果:
引用式链接
[链接文本][1][另一个链接][link-ref]
[1]: https://example.com[link-ref]: https://example.com "可选标题"
自动链接
<https://example.com><email@example.com>
效果:
图片语法
行内图片

引用式图片
![替代文本][image-ref]
[image-ref]: 图片URL "可选标题"
列表语法
无序列表
使用 -
、*
或 +
创建无序列表:
- 项目一- 项目二 - 子项目 2.1 - 子项目 2.2- 项目三
效果:
- 项目一
- 项目二
- 子项目 2.1
- 子项目 2.2
- 项目三
有序列表
使用数字加点创建有序列表:
1. 第一项2. 第二项 1. 子项目 2.1 2. 子项目 2.23. 第三项
效果:
- 第一项
- 第二项
- 子项目 2.1
- 子项目 2.2
- 第三项
任务列表
- [x] 已完成任务- [ ] 未完成任务- [x] 另一个已完成任务
效果:
- 已完成任务
- 未完成任务
- 另一个已完成任务
引用语法
使用 >
创建引用:
> 这是一个引用>> 可以包含多个段落>> > 这是嵌套引用
效果:
这是一个引用
可以包含多个段落
这是嵌套引用
代码语法
行内代码
使用反引号包围:
这是 `行内代码` 示例
效果:这是 行内代码
示例
代码块
使用三个反引号创建代码块:
```这是一个代码块可以包含多行代码```
指定语言的代码块
```javascriptfunction hello() { console.log("Hello World!");}```
效果:
function hello() { console.log("Hello World!");}
分隔线
使用三个或更多的连字符、星号或下划线:
---***___
效果:
表格语法
| 左对齐 | 居中对齐 | 右对齐 ||:-------|:--------:|-------:|| 内容1 | 内容2 | 内容3 || 长内容 | 短内容 | 中等 |
效果:
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
内容1 | 内容2 | 内容3 |
长内容 | 短内容 | 中等 |
转义字符
当你需要显示 Markdown 语法字符本身时,可以使用反斜杠进行转义:
字符 | 转义语法 | 效果 |
---|---|---|
* | \* | * |
_ | \_ | _ |
# | \# | # |
+ | \+ | + |
- | \- | - |
. | \. | . |
! | \! | ! |
[ | \[ | [ |
] | \] | ] |
( | \( | ( |
) | \) | ) |
实用技巧
1. 换行技巧
- 段落分隔:段落间空一行
- 强制换行:行末加两个空格
- HTML换行:使用
<br>
标签
2. 空格技巧
- 不间断空格 
- 半角空格 
- 全角空格
3. 特殊符号
描述 | 语法 | 效果 |
---|---|---|
版权符号 | © | © |
注册商标 | ® | ® |
商标符号 | ™ | ™ |
左箭头 | ← | ← |
右箭头 | → | → |
4. 键盘按键
按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制
效果:按 Ctrl + C 复制
最佳实践
1. 文档结构
- 使用标题创建清晰的文档结构
- 合理使用列表组织信息
- 适当使用引用突出重要内容
2. 可读性
- 在标题和内容之间留空行
- 使用一致的列表符号
- 保持代码块的语言标识
3. 兼容性
- 避免使用过于复杂的嵌套结构
- 测试在不同平台上的显示效果
- 使用标准语法确保兼容性
总结
Markdown 的基础语法简单易学,掌握了这些语法,你就可以:
- 快速编写格式化文档
- 专注内容而不是格式
- 跨平台兼容,在各种编辑器中使用
- 版本控制友好,便于协作开发
- 易于转换为 HTML、PDF 等格式
这些基础语法是所有 Markdown 编辑器都支持的标准语法。掌握了基础语法后,你可以进一步学习各种扩展语法和高级功能。
希望这份 Markdown 基础语法指南对你有帮助!如果你想了解更多高级功能,可以查看我们的进阶语法指南。
Markdown 基础语法指南
https://www.shimoxi.qzz.io/2025/07/14/18/ 评论
正在加载评论系统...