464 字
1 分钟
markdown语法学习
这篇文章整理了常用 Markdown 语法，包含基础写法与实战中高频使用的扩展语法。
基础语法
1. 标题
Markdown 使用 # 表示标题，# 数量对应标题级别：
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题2. 段落与换行
段落之间使用空行分隔。段内换行常见有两种方式：
这是第一行（行尾两个空格）这是第二行
这是新段落。3. 强调
使用 * 或 _ 包裹文本可实现强调：
*斜体文本***加粗文本*****粗斜体文本***4. 列表
无序列表可使用 -、*、+，建议全文统一一种风格（常用 -）。
- 无序列表项 1 - 子项 1.1 - 子项 1.2- 无序列表项 2- 无序列表项 1
- 子项 1.1
- 子项 1.2
- 无序列表项 2
有序列表使用数字加点：
1. 有序列表项 1 1. 子项 1.1 2. 子项 1.22. 有序列表项 23. 有序列表项 3- 有序列表项 1
- 子项 1.1
- 子项 1.2
- 有序列表项 2
- 有序列表项 3
5. 链接与图片
[链接文本](https://example.com "可选标题，hover显示")[相对路径链接](/about/ "内部页面")
[Google](https://www.google.com)
图片链接格式，语法与链接类似，前缀加 !6. 代码
行内代码用反引号包裹：
这是一个 `行内代码` 示例。多行代码块使用三个反引号，并建议标注语言：
def hello_world(): print("Hello, World!")7. 分隔线
一行内使用 3 个及以上 *、-、_，且行内无其他内容：
内容 1___内容 2***内容 3___内容 1
内容 2
内容 3
常用扩展语法
8. 引用
> 这是一级引用>> 这是二级引用9. 表格
| 功能 | 语法 | 示例 || -------- | ------------ | -------- || 加粗 | `**text**` | **text** || 斜体 | `*text*` | *text* || 行内代码 | `` `code` `` | `code` || 功能 | 语法 | 示例 |
|---|---|---|
| 加粗 | **text** | text |
| 斜体 | *text* | text |
| 行内代码 | hello world | code |
10. 任务列表
- [x] 完成 Markdown 基础整理- [ ] 补充 Mermaid 示例- [ ] 增加发布前检查清单11. 删除线与高亮（部分平台支持）
~~这是删除线~~==这是高亮==这是删除线
==这是高亮==
12. 脚注（部分平台支持）
这是一句话，带一个脚注。[^1]
[^1]: 这是脚注内容。这是一句话，带一个脚注。1
13. 锚点与目录
很多静态站点会自动根据标题生成锚点，可以手动写目录：
- [基础语法](#基础语法) - [1. 标题](#1-标题) - [2. 段落与换行](#2-段落与换行)- [常用扩展语法](#常用扩展语法)写作建议
- 标题层级不要跳级，便于生成清晰目录。
- 列表符号、标点和空格风格尽量统一。
- 代码块优先标注语言，提升可读性与高亮效果。
- 发布前在目标平台预览，确认扩展语法是否被支持。
Footnotes
-
这是脚注内容。 ↩
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
部分信息可能已经过时
相关文章 智能推荐
1
创建文章
Examples 在 Mizuki 博客系统中使用文件夹方案创建文章，适合包含大量图片和资源的复杂内容管理。
2
python学习笔记
Lauguages 重新学习python基本语法，特性记录一些学习笔记
3
CTU-MRS 双无人机灾后巡检项目复现记录
Weekly Summary 记录 CTU-MRS Summer School 2026 双无人机灾后巡检项目的用途、运行环境、部署过程，以及源码复制、容器镜像和 ROS 工作区编译中遇到的问题。
4
VS Code Remote SSH 中 Codex 登录 403 的排查与解决
开发工具 记录 Codex 在 VS Code Remote SSH 环境中登录时报 Token exchange failed 403 Forbidden 的原因、SSH 反向端口转发配置与排查方法
5
字符编码入门：从 VS Code 终端乱码到 Unicode
从 VS Code 终端乱码、文件读写和网页编码等常见问题出发，介绍 ASCII、Unicode、UTF-8、UTF-16、GBK 与 GB18030，并给出实用的排查方法。