正文

markdown语法详细解析从基础标题代码块到表格引用完整入门指南助你轻松掌握文档排版技巧

/0 浏览量
0901

哈喽！看到标题点进来的你，是不是也被那些满屏的代码或者复杂的排版文档吓退过？别怕，今天咱们不聊那些晦涩难懂的术语，就把 Markdown 当成你写文档时的“魔法铅笔”。不管你是刚入门的小白，还是想找回写作快感的开发者，这篇指南都能让你从零开始，写出像杂志一样漂亮的文档。

咱们这就开始，一点点把 Markdown 的魔力拆解给你看。

为什么是 Markdown？先听听我的心声

说实话，以前我也烦透了 Word。每次想加个标题，得选中、改字号、调行距；想插个代码，还得调整缩进，生怕格式乱掉。直到我遇见了 Markdown，那种“只管写，格式自动来”的感觉，就像脱掉了紧身衣，浑身轻松。

Markdown 的核心理念其实就一个：让写作回归内容本身。你只需要在键盘上敲击几个简单的符号，渲染器就会自动帮你把文档变得整洁、专业。无论是在 GitHub 上看 README，还是在 Typora 里写笔记，或者是用 Notion 整理生活，Markdown 都是那个最通用、最优雅的语言。

准备好了吗？咱们从最基础的大标题开始，一步步往下挖。

第一层：搭建骨架——标题与段落

文档就像一栋房子，标题就是它的梁柱，决定了整体的结构。在 Markdown 里，标题简单到令人发指：只需要在行首加上一个或多个 # 号。

标题的等级秘密

  • 一级标题（H1）：一个大 #，通常用作文档的主标题，最大最醒目。
  • 二级标题（H2）：两个 ##，用于主要章节。
  • 三级标题（H3）：三个 ###，用于小节。
  • 更高级别：一直用到六个 ######（H6），虽然很少用，但知道有这回事总没坏处。

试试这段代码，看看效果：

# 这是我的主标题，超级大气
## 这是第二大标题，用来分章节
### 这是小标题，细节之处见真章
#### 四级标题，几乎没人用，但你可以炫耀一下

渲染出来大概是这样的：

这是我的主标题，超级大气

这是第二大标题，用来分章节

这是小标题，细节之处见真章

四级标题，几乎没人用，但你可以炫耀一下

段落的呼吸感

写文章不能一直挤在一起，段落之间要留出“呼吸感”。在 Markdown 里，你只需要空一行，两个段落就自动分开了。

这是第一段，我讲的是 Markdown 的起源。

这是第二段，我想聊聊它为什么这么流行。

是不是比在 Word 里按回车键两次还要简单？而且，当你换行时，Markdown 默认不会立刻分段，除非你空一行。这很重要，有时候你想在一段话里强制换行（比如写诗歌或者地址），可以在行尾加两个空格，然后按回车。

床前明月光，  
疑是地上霜。  
举头望明月，  
低头思故乡。

注意：最后一行不需要加空格，否则后面可能会多出奇怪的空白。

第二层：强调重点——粗体、斜体与删除线

在写作中，我们总是需要强调某些词，或者表达某种情绪。Markdown 提供了几种简单的语法来做这件事。

粗体：大声喊出重点

想要让某个词突出显示吗？用两个星号 ** 或者两个下划线 __ 把它包起来。

**这是粗体**
__这也是粗体__

效果：这是粗体 / 这也是粗体

斜体：轻声细语的补充

斜体通常用于引用、术语或者表示犹豫、轻微的语气。用单个星号 * 或下划线 _ 包裹。

*这是斜体*
_这也是斜体_

效果：这是斜体 / 这也是斜体

粗斜体：双重强调

如果你需要一个词既粗又斜，那就叠罗汉吧！用三个星号 ***。

***这是粗斜体***

效果：这是粗斜体

删除线：表示废弃或错误

有时候，我们需要划掉一些旧的内容，或者表示这个想法已经过时了。用两个波浪号 ~~ 包裹文字。

~~这句话已经被删除了~~

效果：这句话已经被删除了

第三部分：引用与列表——让逻辑更清晰

好的文档不仅有结构，还要有清晰的逻辑层次。引用、有序列表和无序列表就是你的逻辑工具。

引用：借他人的口

引用通常用于表示摘录、引用来源或者强调某人的观点。在行首加一个 > 即可。

> 这是第一行引用。
> 这是第二行引用，可以换行。

> 爱因斯坦说过：
> “想象力比知识更重要。”

效果：

这是第一行引用。 这是第二行引用，可以换行。

爱因斯坦说过： “想象力比知识更重要。”

无序列表：随意的清单

如果你想列出一堆没有顺序要求的事情，用 -、* 或 + 开头。

- 苹果
- 香蕉
- 橙子

或者

* 苹果
* 香蕉
* 橙子

效果：

  • 苹果
  • 香蕉
  • 橙子

有序列表：步步为营

如果有先后顺序，比如步骤、排名，就用数字加点 1.。

1. 第一步，打开编辑器
2. 第二步，输入代码
3. 第三步，运行并查看结果

效果：

  1. 第一步，打开编辑器
  2. 第二步，输入代码
  3. 第三步，运行并查看结果

嵌套：列表中的列表

有时候，我们需要更复杂的层级。只要缩进两个空格（或一个 Tab），就能在列表里套列表。

- 水果
  - 苹果（红的）
  - 香蕉（黄的）
- 蔬菜
  - 白菜
    - 大白菜
    - 小白菜

效果：

  • 水果
    • 苹果（红的）
    • 香蕉（黄的）
  • 蔬菜
    • 白菜
      • 大白菜
      • 小白菜

第四部分：代码与特殊字符——程序员的专属浪漫

如果你是个开发者，或者需要在文档中展示技术内容，这部分是必须的。Markdown 对代码的支持非常贴心。

行内代码：短小精悍

当你想在一段话里提到某个变量、函数名或者命令时，用反引号 ` 把它包起来。

请在终端输入 `npm install` 来安装依赖。

效果：请在终端输入 npm install 来安装依赖。

代码块：大块代码的舞台

如果代码超过几行，或者你需要保持缩进格式，就要用到代码块了。用三个反引号 “` 包裹。

function greet(name) {
    console.log("Hello, " + name + "!");
}

greet("Agnes");

效果：

function greet(name) {
    console.log("Hello, " + name + "!");
}

greet("Agnes");

小技巧：在第一个 “后面加上语言名称（如javascript、python、markdown`），很多编辑器会为你高亮代码，看起来更专业。

转义字符：对抗 Markdown

有时候，你就想显示一个普通的 * 或 #，而不是让它变成格式符号怎么办？用反斜杠 \ 转义。

\*这不是斜体\*
\# 这不是标题

效果：这不是斜体 / # 这不是标题

第五部分：表格——数据的艺术

表格在 Markdown 里有点特殊，它需要一些对齐技巧。虽然不如 Excel 那么强大，但用来展示对比数据完全够用。

基础表格语法

第一行是表头，第二行是分隔线（必须包含至少三个 -），第三行开始是数据。

| 姓名 | 年龄 | 职业 |
| ---- | ---- | ---- |
| 小明 | 25 | 工程师 |
| 小红 | 28 | 设计师 |
| 小刚 | 30 | 产品经理 |

效果：

姓名 年龄 职业
小明 25 工程师
小红 28 设计师
小刚 30 产品经理

对齐方式

默认情况下，文字是左对齐的。你可以通过在分隔线的冒号 : 来控制对齐：

  • :--- 左对齐
  • :---: 居中对齐
  • ---: 右对齐

试试这个：

| 左对齐 | 居中 | 右对齐 |
| :----- | :--: | -----: |
| 文本1  | 文本2 | 文本3 |
| 数字1  | 数字2 | 数字3 |

效果：

左对齐 居中 右对齐
文本1 文本2 文本3
数字1 数字2 数字3

第六部分：链接与图片——让文档“活”起来

纯文本是孤独的，加上链接和图片，文档就有了生命。

超链接：点击即达

语法是 [链接文字](URL)。

[访问 Sapiens AI 官网](https://www.sapiens.ai)

效果：访问 Sapiens AI 官网

你也可以给链接加个标题，鼠标悬停时显示：

[访问 Sapiens AI 官网](https://www.sapiens.ai "去 explore 一下")

图片：一图胜千言

图片的语法和链接很像，只是在前面加个感叹号 !。

![这是一张示例图片](https://via.placeholder.com/150)

效果：这是一张示例图片

提示：alt 文本（! 后面的括号内容）是为了当图片加载失败时显示的提示，也便于屏幕阅读器为视障用户描述图片，所以不要省略它，写上简短的描述。

第七部分：分割线与任务列表——细节决定成败

水平分割线

当你想区分不同部分的内容时，可以用水平线。输入三个或更多的 -、* 或 _。

---

效果：

任务列表：待办事项的福音

Markdown 还支持任务列表，特别适合写TODO清单。

- [x] 已完成的任务
- [ ] 待完成的任务
- [ ] 另一个待办

效果：

  • [x] 已完成的任务
  • [ ] 待完成的任务
  • [ ] 另一个待办

注意：方括号内必须有空格，[ ] 表示未完成，[x] 表示已完成。

实战演练：把所有技巧串起来

光说不练假把式。下面我为你准备了一个完整的 Markdown 示例，涵盖了今天学到的大部分内容。你可以复制这段代码，放到任何支持 Markdown 的编辑器（如 Typora、VS Code、Obsidian）里预览，看看效果。

# Markdown 入门完全指南

> 本文旨在帮助初学者快速掌握 Markdown 的基本用法。

## 为什么学习 Markdown？

Markdown 是一种**轻量级标记语言**，它允许人们使用**易读易写**的纯文本格式编写文档。

### 优势

1. **简洁**：语法简单，易于记忆。
2. **通用**：几乎在所有编程平台和博客系统中都支持。
3. **专注**：让你专注于内容，而非排版。

## 代码示例

如果你在编程，经常会用到代码块。比如 Python：

```python
def hello_world():
    print("Hello, World!")

hello_world()

在 JavaScript 中：

const greeting = "Hello, World!";
console.log(greeting);

数据对比

下表展示了两种语言的运行速度对比：

语言 执行速度 学习难度 适用场景
Python 慢 低 数据分析、AI
JavaScript 快 中 前端开发
C++ 极快 高 系统编程

待办事项

  • [x] 学习 Markdown 基础
  • [ ] 练习编写文档
  • [ ] 将 Markdown 应用到博客中
  • [ ] 探索更多高级功能

希望这篇指南对你有所帮助！ “`

最后的话：多练才能生巧

好了，今天的分享就到这里。我知道一口气塞这么多语法有点多，但别担心，Markdown 的学习曲线非常平缓。你不需要死记硬背所有符号，只需要常用那些：

  • 标题 #
  • 粗体 **
  • 列表 - 或 1.
  • 引用 >
  • 代码 `

其他的，等你用到的时候，随手搜一下就行。毕竟，工具是为人服务的，而不是让人去伺候工具的。

我建议你接下来做一个小练习：用 Markdown 写一篇你自己的自我介绍，或者记录一下今天的日记。试着加入标题、列表、粗体，甚至一张图片。当你第一次看到自己写的纯文本变成漂亮排版的那一刻，你会爱上这种感觉的。

记住，写作是一件快乐的事，别让复杂的格式软件拖慢了你的思绪。拿起你的编辑器，开始写吧！

如果还有任何问题，欢迎随时回来翻看这篇指南，或者在评论区留言，我会尽力帮你解答。祝你写作愉快！

-- 展开阅读全文 --