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),扩展语法(如任务列表)需看编辑器支持。
相关推荐
方安乐12 小时前
ESLint代码规范(一)
前端·javascript·代码规范
Re_zero13 小时前
throws 还是 try-catch?Code Review 里被我打回最多的异常处理
java·代码规范
集成显卡1 天前
别局限于 Oh-My-Posh,试试 Rust 编写的 starship:极简超快且无限可定制的命令行提示符
程序员·代码规范·命令行
行百里er2 天前
优雅应对异常,从“try-catch堆砌”到“设计驱动”
java·后端·代码规范
码财小子2 天前
聊聊 C++ 模块“注册式”的优雅姿势
后端·代码规范
殷紫川2 天前
Java 工程化体系:代码规范与团队协作全链路标准
java·架构·代码规范
本末倒置1832 天前
告别"话痨"提交记录!Git 压缩 Commit 实战指南,代码洁癖党狂喜
面试·程序员·代码规范
码农刚子6 天前
字符串拼接用“+”还是 StringBuilder?别再凭感觉写了
后端·代码规范
道一云黑板报7 天前
技术拆解:AI低代码架构设计与全链路落地实现
人工智能·驱动开发·低代码·ai·企业微信·ai编程·代码规范
CoovallyAIHub7 天前
Django 大佬亲授:8 个 Coding Agent 工程模式,重新定义程序员价值
程序员·测试·代码规范