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),扩展语法(如任务列表)需看编辑器支持。
相关推荐
逍遥德2 天前
如何学编程之02.理论篇.如何写出具有良好健壮性的代码?
java·开发语言·性能优化·代码规范·代码复审
正是江南好时节3 天前
踩坑小记之闭包陷阱
前端·javascript·代码规范
SuperEugene3 天前
从 0-1 轻松学会 Vue3 Composables(组合式函数),告别臃肿代码,做会封装的优雅前端
vue.js·代码规范
玖月晴空4 天前
探索关于Spec 和Skills 的一些实战运用-Kiro篇
前端·aigc·代码规范
HellowAmy4 天前
我的C++规范 - 鸡蛋工厂
开发语言·c++·代码规范
邵伯正在输入5 天前
一次项目结构调整带来的“灾难”
团队开发·代码规范·源代码管理
逍遥德6 天前
如何学编程之01.理论篇.如何通过阅读代码来提高自己的编程能力?
前端·后端·程序人生·重构·软件构建·代码规范
HellowAmy7 天前
我的C++规范 - 线程池
开发语言·c++·代码规范
巴巴博一12 天前
抛弃 ESLint + Prettier?基于 Biome + Husky 的下一代前端工程化实践
代码规范