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),扩展语法(如任务列表)需看编辑器支持。
相关推荐
进击的丸子1 小时前
APP 人脸识别增值版 SDK:Camera2 无缝接入指南
前端·前端框架·代码规范
深圳老胡4 小时前
FDC2212 + STM32G030 液面探测:IIC 读数跳动导致下探深度不一致的排查与解决
笔记·stm32·单片机·代码规范·1024程序员节
阿俊-全栈开发1 天前
LikeShop 二开代码规范:目录结构、钩子使用与版本升级兼容方案
代码规范·likeshop开源商城·likeshop单商户标准版·多商户源码
深圳老胡1 天前
STM32 开发中 Trae 内置模型怎么选:Seed、MiniMax、GLM、DeepSeek、Kimi、Qwen 全对比
笔记·stm32·单片机·嵌入式硬件·代码规范·1024程序员节
喵个咪2 天前
AI 时代的危与机:当潮水退去,技术人如何自处
ai编程·代码规范
六个蒙多都说少之一拳下去那得是2 天前
Git 与 GitHub 从零到协作:核心操作完全指南
github·代码规范
hunter_0762 天前
App 被苹果 4.3 拒绝怎么办?从官方条款到整改、沟通与申诉
面试·代码规范
深圳老胡2 天前
STM32 工程在 VSCode 中用 AI 搭建软件骨架架构:从零到可运行的分层实践
笔记·stm32·单片机·代码规范
深圳老胡2 天前
STM32 工程在 VS Code 中的编译与调试:AI 辅助工具实战指南
笔记·stm32·单片机·代码规范
这个DBA有点耶3 天前
索引建了查询却更慢——优化器选错索引与Index Merge的隐藏代价
数据库·架构·代码规范