Markdown格式.md文件的编辑预览使用
推荐工具
Visual Studio Code (VS Code) - 强烈推荐
特点:微软出品,免费、开源、跨平台(Windows, macOS, Linux)。拥有海量插件市场。
编辑体验:安装 Markdown All in One 等插件后,可以获得语法高亮、实时预览、目录生成、表格格式化等强大功能。
快捷键
快捷键大法(强烈推荐)
在打开的
.md
文件中,直接按下Ctrl + K
,然后松开,再按V
。效果:右侧会分屏打开一个预览窗口,并且实时同步你左侧编辑的内容
编辑语法
基础语法(最常用)
以下内容在绝大多数支持 Markdown 的平台上均可通用:
1.标题(Headers)
使用 # 符号定义标题级别,1-6 个 # 分别对应 HTML 中的 <h1> 至 <h6> 标签。
# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
##### 五级标题 (H5)
###### 六级标题 (H6)
实际效果:
一级标题 (H1)
二级标题 (H2)
三级标题 (H3)
2. 段落与换行 (Paragraphs and Line Breaks)
段落:使用空行分隔段落。
这是第一段落。这是第二段落。
换行:行尾添加两个空格后回车,或使用空行(但后者不构成严格段落)。
第一行结尾包含两个隐藏空格
第二行内容。
3. 强调 (Emphasis)
斜体 (Italic)
使用单个*
或_
包裹文本:
*斜体文本示例*
_另一种斜体表示方式_
粗体 (Bold)
使用双*
或_
包裹文本:
**粗体文本示例**
__另一种粗体表示方式__
粗斜体 (Bold and Italic)
使用三*
或_
包裹文本:
***粗斜体文本示例***
___另一种粗斜体表示方式___
效果:
这是斜体文本
这是粗体文本
这是粗斜体文本
4. 列表 (Lists)
有序列表 (Ordered Lists)
使用数字加点号表示:
1. 第一项
2. 第二项
3. 第三项
无序列表 (Unordered Lists)
使用-
、*
或+
表示:
- 项目一
* 项目二
+ 项目三
嵌套列表
在子项目前使用2或4个空格缩进:
1. 第一项- 第一项的子项- 另一个子项
2. 第二项
效果演示:
- 第一项
- 第一项的子项
- 另一个子项
- 第二项
- 项目一
- 项目二
5. 链接 (Links)
行内链接
使用格式:[链接文本](URL "标题(可选)")
示例:
访问 [Google](https://www.google.com) 搜索。
访问 [Google](https://www.google.com "Google 主页") 搜索。
引用式链接
适用于重复使用的链接,保持文档整洁。
示例:
这是一个引用式链接 [Example][1] 的例子。[1]: http://example.com/ "Optional Title"
6. 图片 (Images)
语法与链接类似,前面加!
号:
")
示例:

效果说明:
- 图片URL有效时会显示图片
- 替代文本在图片无法加载时显示
7. 代码 (Code)
行内代码:使用单个反引号 ` 包裹内容。
示例:
使用 `printf()` 函数打印
代码块:使用三个反引号 ``` 包裹代码,可在开头指定语言实现语法高亮。
示例:
```python
def hello_world():print("Hello, World!")
```
效果: 使用 printf()
函数打印
def hello_world():print("Hello, World!")