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 天前
agent-skills:把资深工程师的‘工作流’,装进你的AI编程里
前端·架构·代码规范
喝拿铁写前端2 天前
AI 时代,ESLint 应该怎么做得更好
前端·人工智能·代码规范
饼干哥哥3 天前
Lovart真的帮大忙了,一键直出品牌视觉套件和个人IP封面Skill
人工智能·代码规范·设计
饼干哥哥4 天前
单篇100万阅读文章,如何用AI 做好内容创作?
人工智能·正则表达式·代码规范
程序员agions4 天前
RuView 新手快速上手与实战指南
代码规范
至乐活着4 天前
前端工程化最佳实践:从规范到自动化构建的全面指南
webpack·自动化·代码规范·构建工具·前端工程化
饼干哥哥5 天前
一篇文章卖了20万,开源CC+Obsidian打造的LLM Wiki 内容创作3.0系统
架构·开源·代码规范
997_oo5 天前
MCP踩坑记录
代码规范
梦梦代码精6 天前
电商系统不是技术堆叠:LikeShop如何用分层Hold住复杂业务?
java·docker·代码规范
想你依然心痛7 天前
嵌入式C代码规范:MISRA-C 2012核心规则解读——类型安全与未定义行为深度剖析
c语言·安全·代码规范