N NaSpace

Markdown 详细语法教程(从入门到实战)

作者:admin · 更新于 2026-07-06 14:52:04

Markdown 是一种轻量级标记语言,通过简单的符号即可完成排版,非常适合写博客、写文档、做笔记、写 README 等。

它的核心思想是:用最少的语法表达结构,而不是复杂排版。


一、Markdown 标题语法

Markdown 使用 # 表示标题,共有 6 级标题。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

👉 示例效果:

一级标题

二级标题

三级标题


二、段落与换行

Markdown 中:

  • 段落之间需要空一行
  • 单换行不会真正换段(部分渲染器支持)
这是第一段。

这是第二段。

三、强调语法(重点)

1. 加粗

**加粗文字**

效果:加粗文字


2. 斜体

*斜体文字*

效果:斜体文字


3. 加粗 + 斜体

***加粗斜体***

效果:加粗斜体


四、列表语法

1. 无序列表

- 苹果
- 香蕉
- 橘子

效果:

  • 苹果
  • 香蕉
  • 橘子

也可以用 *+


2. 有序列表

1. 第一步
2. 第二步
3. 第三步

效果:

  1. 第一步
  2. 第二步
  3. 第三步

3. 嵌套列表

- 水果
- 苹果
- 香蕉
- 蔬菜
- 西红柿

五、引用语法

> 这是引用内容
> 用于强调一句话或引用文章

效果:

这是引用内容
用于强调一句话或引用文章


六、代码语法

1. 行内代码

这是 `console.log()` 示例

效果:这是 console.log() 示例


2. 代码块

```javascript
function hello() {
console.log("Hello Markdown");
}

效果:

```javascript
function hello() {
console.log("Hello Markdown");
}

七、链接语法

[Google](https://www.google.com)

效果:Google


八、图片语法

![图片描述](https://example.com/image.png)

说明:

  • [] 是图片说明(alt)
  • () 是图片地址

九、分割线

---

效果:


也可以用:

***

十、表格语法(非常重要)

| 名称 | 年龄 | 职业 |
|------|------|------|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |

效果:

名称年龄职业
张三25工程师
李四30设计师

十一、任务列表(Checklist)

- [x] 已完成任务
- [ ] 未完成任务

效果:

  • 已完成任务
  • 未完成任务

十二、转义字符

如果你想显示 Markdown 符号本身,可以使用 \ 转义:

\*不是斜体\*

效果:*不是斜体*


十三、Markdown 扩展语法(进阶)

不同平台支持不同扩展,例如:

1. 删除线

~~删除内容~~

效果:删除内容


2. 脚注(部分平台支持)

这是一个脚注[^1]

[^1]: 这是脚注内容

十四、Markdown 实际应用场景

Markdown 被广泛用于:

  • GitHub README
  • 技术文档(Docs)
  • 博客系统(Hexo / Hugo)
  • Notion / Obsidian 笔记
  • API 文档
  • Chat 记录整理

十五、总结

Markdown 的核心优势只有一句话:

用最简单的符号,表达最清晰的结构。

掌握以下 5 个就已经够日常使用:

  • 标题 #
  • 列表 - / 1.
  • 加粗 **
  • 代码 `
  • 链接 []()

Comments

评论

暂无评论,欢迎留下第一条想法。