主题
Markdown 语法简洁整理
基本信息
- 轻量级标记语言
- VS Code 插件推荐:1. Markdown Preview Enhanced(可转换为 PDF、HTML 等)2. Markdown to Word(可直接导出 Word 文档)
- 参考链接:Markdown 教程
语法指南(仅知识点)
1. 标题---(1个#到6个#,仅左边,有空格)
- 1-6 级别:
#到###### - 只用左侧添加,不用两侧包裹
2. 段落---(空行分隔)
- 段落之间用空行分隔
3. 分割线---(多个*)
- 使用
***(或---、___,渲染效果相同)
4. 文本格式化-----(一个斜体,2个粗体,3个粗斜体,2个~~删除线)
- 斜体:
*斜体* - 粗体:
**粗体** - 粗斜体:
***粗斜体*** - 删除线:
~~删除线~~
5. 列表---(1.无序:*跟空格,2.有序:数字跟空格,3.嵌套:多个空格)
- 无序列表:
*后跟空格(转义\*可显示原样星号) - 有序列表:数字加
. - 嵌套列表:子项前加 2 或 4 个空格
6. 引用---(比代码块更高亮效果,多了>字符)
- 使用
>标记,可嵌套
7. 代码
- 行内代码:
`包裹 - 代码块:
包裹,可指定语言实现高亮
8. 链接---(方框是文字,括号是地址)
- 语法:
[链接名称](链接地址)
9. 图片(比链接多了!,可以预览显示)
- 语法:

10. 表格
|分隔单元格,---作表头分割线- 对齐:
:---左、---:右、:---:居中,缺省默认左对齐
11. 任务列表
- 未完成
- [ ],已完成- [x]
12. HTML 标签支持---(建议只用kbd)
- 行内标签:
strong、em、del、ins、sup、sub、b、s、u - 结构标签:
ol-li、ul-li;样式style kbd标签用于高亮按键(如Ctrl + C)
13. 数学公式---(行内 $...$,块级 $$...$$)
- 行内
$...$,块级$$...$$
最佳实践
- 使用
*而不是_进行文本强调 - 使用
而不是 ~~~ ~~~ 进行代码块标记 - 表格使用对齐标记使布局更清晰
- 任务列表用于跟踪项目进度
kbd标签在编写操作手册时非常有用
综合实例(语法参考,代码块)
以下为原始写法,便于复制对照:
markdown
# 二级标题
## 三级标题
这是一个段落。
这是换行后的内容(行尾两空格)。
*斜体* **粗体** ***粗斜体*** ~~删除线~~
---
* 无序项一
* 无序项二
* 嵌套子项
1. 第一步
2. 第二步
> 一级引用
> > 嵌套引用
行内代码示例:`console.log("hi")`
```javascript
function hello() {
console.log("Hello");
}
```
| 左对齐 | 右对齐 | 居中对齐 |
| :--- | ---: | :---: |
| 单元格 | 单元格 | 单元格 |
质能方程:$E=mc^2$渲染预览(查看实际效果)
以下直接渲染,可对照上方语法看效果:
链接与图片
任务列表
- [x] 已完成任务
- [ ] 未完成任务
表格
| 功能 | 描述 | 状态 |
|---|---|---|
| 文本格式化 | 支持斜体、粗体等 | ✅ |
| 列表功能 | 支持有序和无序列表 | ✅ |
| 链接功能 | 支持添加外部链接 | ✅ |
| 图片功能 | 支持插入图片 | ✅ |
| 代码高亮 | 支持代码语法高亮 | ✅ |
联系方式