Markdown常用标准语法

Markdown 是轻量级标记语言,语法简单且跨平台通用(几乎所有笔记 / 文档工具都支持),且是现在AI提示词的主流格式,以下是通用标准语法(不含各平台扩展语法):


1. 标题

用#表示标题级别,#数量对应 1-6 级标题,#和文字之间必须加空格(新手易出错)。

markdown

shell 复制代码
# 一级标题(最大)
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题(最小)

日常使用中 1-3 级标题最常用,六级标题几乎很少用到。

2. 文本强调(粗体 / 斜体 / 删除线)

表格

效果 语法 示例 渲染效果
粗体 **文字** **重要内容** 重要内容
斜体 *文字* *备注信息* 备注信息
粗斜体 ***文字*** ***核心重点*** 核心重点
删除线 ~~文字~~ ~~作废内容~~ 作废内容

3. 列表(无序 / 有序 / 嵌套)

无序列表

用-/+/*开头(选一种即可),符号后加空格:

markdown

markdown 复制代码
- 列表项1
- 列表项2
  - 嵌套子项(缩进2个空格)
+ 另一种无序列表

有序列表

用数字.开头,符号后加空格:

markdown

markdown 复制代码
1. 第一步
2. 第二步
   1. 嵌套子步骤
3. 第三步

4. 链接与图片

链接

  • 行内链接(最常用):[链接文字](链接地址 "可选标题")

    markdown

    less 复制代码
    [百度](https://www.baidu.com "百度首页")
  • 锚点链接(跳转到文档内位置):[回到顶部](#一级标题)

图片

语法和链接类似,只是开头多一个!:

markdown

less 复制代码
![图片替代文字](图片URL "可选标题")
# 替代文字:图片加载失败时显示的文字;标题:鼠标悬停时显示
![示例图](https://example.com/img.jpg "这是一张示例图")

5. 代码(行内 / 块级)

行内代码

用单个反引号`````包裹,适合标注少量代码 / 命令:

markdown

css 复制代码
执行`python main.py`命令启动程序

代码块

用三个反引号 ``` 包裹,指定语言可实现语法高亮:

markdown

scss 复制代码
```python
# 这是Python代码示例
def hello():
    print("Hello Markdown!")
hello()

plaintext

shell 复制代码
### 6. 引用
用`>`开头,嵌套引用加多个`>`:
```markdown
> 一级引用(比如引用他人观点)
>> 二级嵌套引用
>>> 三级嵌套引用

7. 分割线

用连续的 3 个及以上-/*/_(单独一行,前后空行):

markdown

yaml 复制代码
---
***
___

⚠️ 注意:不要混写(比如-*-),保持统一更规范。

8. 表格

用|分隔列,第二行用-分隔表头和内容,:控制对齐:

markdown

ruby 复制代码
| 姓名 | 年龄 | 城市 |
| :--- | :--: | ---: |
| 张三 | 20   | 北京 |
| 李四 | 25   | 上海 |
# 对齐规则::---(左对齐)、:--:(居中)、---:(右对齐)

9. 转义字符

如果想显示 Markdown 特殊符号(比如#/*/[ ]),用``转义:

markdown

markdown 复制代码
# 这不是标题(原本#是标题符号,转义后仅显示#)
* 这不是斜体

总结

  1. Markdown 核心是 "符号 + 空格" 的组合,符号与文字间的空格是新手最容易忽略的关键;
  2. 常用语法优先掌握:标题、粗体 / 斜体、列表、代码块、链接,能满足 80% 的日常使用场景;
  3. 标准语法跨平台通用(如 Typora、VS Code、GitHub),扩展语法(如任务列表)需看编辑器支持。
相关推荐
Awei爱emo19 小时前
写到一半被叫去修 bug?别再 stash 了,用 Git Worktree 开张"新桌子"
代码规范
这个DBA有点耶6 天前
MySQL字符集与排序规则深入:索引失效的隐蔽场景与排查方法
数据库·mysql·代码规范
咖啡八杯6 天前
常量与枚举设计规范:HttpStatus 自定义 601 警告码
java·架构·代码规范
这个DBA有点耶8 天前
从异步复制到MGR:MySQL复制机制的三层演进与选型框架
数据库·mysql·代码规范
kisshyshy8 天前
《从屎山到秩序:Vibe Coding 95 驾驭术全公开》
人工智能·代码规范·vibecoding
深圳老胡14 天前
STM32F407 控制 L6470 步进电机驱动 —— 控制过程简介
笔记·stm32·单片机·嵌入式硬件·代码规范
怕浪猫14 天前
ZCode 开源了来看看这是个什么东西
node.js·github·代码规范
Liaiyang6615 天前
# 自研 AST 容错初筛工具:横向评测 Django、PyTorch、TensorFlow 三大开源 Python 框架异常收容风险
python·测试工具·自动化·开源软件·代码规范·devops·代码复审
kisshyshy16 天前
从Props透传到自定义Hook:系统梳理React跨层级通信与逻辑复用
前端·架构·代码规范