正文

写作排版总翻车Markdown语法超详细图解教程从标题到列表代码块全掌握

/0 浏览量
0921

Markdown语法超详细图解教程：从标题到列表、代码块全掌握

你是不是也遇到过这种情况：在知乎、小红书、GitHub上看到别人写的文章排版那么漂亮，轮到自己在博客、论坛里打字的时候，发现格式全乱了？别慌，这篇文章就是来救你的。

Markdown是什么？简单来说，它就是一个”用纯文本实现格式化”的神器。不需要鼠标点来点去，只需要打几个符号，你的文字就能变成标题、列表、代码块、引用……很多程序员、写作者、甚至普通用户都在用它。

下面我从最基础的开始，一步步带你把所有常用语法全部摸透。每个知识点都配上实际例子，你看完就能上手。

一、标题：让重点”跳”出来

标题就是文章的骨架，用#号来表示，几个#就是几级标题。

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

实际效果：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

小贴士：

  • 一级标题一般用一次，作为文章的大标题
  • 二级标题适合做章节标题
  • 三级及以下标题可以根据内容层级使用
  • 每个#和标题文字之间要有一个空格，否则可能显示不正常

二、段落和换行：别让文字挤在一起

这是最简单的部分，但很多人容易忽略。

这是一个段落。段落之间用空行分隔，这样阅读起来会有呼吸感。

这是另一个段落。注意中间的空行，这是关键。

实际效果：

这是一个段落。段落之间用空行分隔，这样阅读起来会有呼吸感。

这是另一个段落。注意中间的空行，这是关键。

换行技巧： 如果你想在同一个段落内换行（不换段落），可以在行尾加两个空格，或者直接按两次回车：

第一行  
第二行（前面有两个空格）

第三行（空行后是新的段落）

实际效果：

第一行
第二行

第三行（空行后是新的段落）

三、粗体和斜体：强调你真正想说的话

Markdown的强调功能非常直观：

这是**粗体文字**，用来强调重点内容。
这是*斜体文字*，用来表示轻微的语气变化。
这是***粗斜体文字***，强调级别最高。
这是~~删除线文字~~，用来表示已作废或删除的内容。

实际效果：

这是粗体文字，用来强调重点内容。 这是斜体文字，用来表示轻微的语气变化。 这是粗斜体文字，强调级别最高。 这是删除线文字，用来表示已作废或删除的内容。

使用场景举例：

  • 粗体：在教程中标注关键操作，比如”点击保存按钮“
  • 斜体：外语词汇、书名、电影名
  • 删除线：记录修改过程，比如”原价¥99，现价¥59，已降价“

四、引用：让重要的话”站”出来

引用用>符号，可以嵌套使用：

> 这是一个简单的引用。
> 
> > 这是嵌套引用，层次更深层。
> 
> 这是回归到第一层。

实际效果：

这是一个简单的引用。

这是嵌套引用，层次更深层。

这是回归到第一层。

实际场景：

  • 博客文章中引用名人名言
  • 论坛回复时引用对方的原话
  • 写笔记时标注重点内容

五、列表：让内容条理清晰

无序列表（项目符号）

用-、+或*都可以，效果一样：

- 苹果
- 香蕉
- 橙子

实际效果：

  • 苹果
  • 香蕉
  • 橙子

注意： -后面要有一个空格，否则会被当成普通文本。

有序列表（编号）

用数字加.：

1. 第一步：打开应用
2. 第二步：点击设置
3. 第三步：保存更改

实际效果：

  1. 第一步：打开应用
  2. 第二步：点击设置
  3. 第三步：保存更改

嵌套列表

列表可以嵌套，用缩进实现：

- 水果
  - 苹果
  - 香蕉
    - 红香蕉
    - 青香蕉
  - 橙子
- 蔬菜
  - 胡萝卜
  - 白菜

实际效果：

  • 水果
    • 苹果
    • 香蕉
      • 红香蕉
      • 青香蕉
    • 橙子
  • 蔬菜
    • 胡萝卜
    • 白菜

列表中的混合格式

你可以在列表项里加粗体、斜体甚至其他格式：

- **重要**：请务必*仔细阅读*以下说明
- 普通说明内容
- ~~过时内容~~（已更新）

实际效果：

  • 重要：请务必*仔细阅读*以下说明
  • 普通说明内容
  • 过时内容（已更新）

六、代码块：程序员和科技爱好者的福音

代码块是Markdown最强大的功能之一，分为行内代码和代码块两种。

行内代码

用反引号`包裹：

在终端输入 `pip install markdown` 即可安装。

实际效果：

在终端输入 pip install markdown 即可安装。

代码块（多行）

用三个反引号包裹，可以指定语言（有助于语法高亮）：

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

hello_world()

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

pip install markdown
npm init -y
git clone https://github.com/user/repo.git


**实际效果：**

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

hello_world()

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

pip install markdown
npm init -y
git clone https://github.com/user/repo.git

常见语言标识符： python、javascript、java、c、c++、bash、shell、html、css、json、sql、ruby、go、rust、markdown、yaml……

七、链接和图片：让内容”活”起来

超链接

格式：[链接文字](URL)

[Visit GitHub](https://github.com)

也可以不带链接文字，直接显示链接：
<https://github.com>

实际效果：

Visit GitHub

也可以不带链接文字，直接显示链接： https://github.com

图片

图片的语法和链接非常像，前面多加一个!：

![这是一个图片描述](https://example.com/image.jpg)

![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png "GitHub Logo")

实际效果：

这是一个图片描述

GitHub Logo

小技巧：

  • 图片描述文字（alt text）是给屏幕阅读器用的，也能在网络图片加载失败时显示
  • 标题文字（title）是鼠标悬停时显示的提示，用双引号包裹

八、表格：数据展示不再头疼

表格用竖线|和横线-来构建：

| 姓名 | 年龄 | 城市 |
|------|------|------|
| 小明 | 25 | 北京 |
| 小红 | 28 | 上海 |
| 小刚 | 22 | 广州 |

实际效果：

姓名 年龄 城市
小明 25 北京
小红 28 上海
小刚 22 广州

对齐方式

你可以控制列的对齐方式，在分隔线的-上加冒号：

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1  |   内容2  |   内容3 |
| 内容4  |   内容5  |   内容6 |

实际效果：

左对齐 居中对齐 右对齐
内容1 内容2 内容3
内容4 内容5 内容6
  • :--- 左对齐
  • :---: 居中对齐
  • ---: 右对齐

九、分割线：区域之间的” Divider”

用三个或以上的-、*或_：

---

***

___

实际效果：

这三大类符号效果是一样的，选一个顺眼的用就好。

十、转义字符：当符号”叛逆”时

有时候你想显示符号本身，而不是让它发挥格式作用。这时可以用反斜杠\来转义：

\*这不是斜体\*
\# 这不是标题
\> 这不是引用
\| 这不是表格 |

实际效果：

*这不是斜体* # 这不是标题 > 这不是引用 | 这不是表格 |

常见的需要转义的符号： \、*、_、{、}、[、]、(、)、#、+、-、.、!、|、>

十一、实战演练：组合使用，写出你的第一篇Markdown文章

下面这篇就是纯Markdown写成的，你可以看看它的效果：

# Markdown入门指南

> 用最简单的语法，写出最漂亮的文档。

## 为什么学习Markdown？

- **简单**：不需要学习复杂的标签语言
- **通用**：几乎所有平台都支持
- **高效**：纯文本，编辑速度快

## 常用语法速查

### 文本格式

| 效果 | 语法 | 示例 |
|------|------|------|
| 粗体 | `**文字**` | `**重要**` |
| 斜体 | `*文字*` | `*注意*` |
| 删除线 | `~~文字~~` | `~~过时~~` |

### 代码示例

```python
print("Hello Markdown!")

链接参考

希望这篇教程对你有帮助！ “`

十二、不同平台的小差异

虽然Markdown是标准语法，但不同平台可能会有自己的扩展：

  • GitHub：支持任务列表（- [ ]和- [x]）、自动链接URL、表格对齐
  • 知乎：支持Markdown，但部分功能可能有限制
  • 微信公众号：不支持原生Markdown，需要用第三方工具转换
  • Typora：支持所有标准Markdown，还有预览模式
  • VS Code：内置Markdown预览，适合写技术文档

写在最后

Markdown其实没有你想象的那么难。你只需要记住几个核心符号：

符号 用途
# 标题
* / ** 斜体 / 粗体
> 引用
- / 1. 列表
` 代码
[ ]( ) 链接
![ ]( ) 图片
--- 分割线
| 表格

掌握这些，你就已经能覆盖90%的日常使用了。剩下的10%，用到的时候查一下就好。

练习建议：

  1. 注册一个GitHub账号，随便写个README.md文件
  2. 用Typora打开一篇Markdown文件，边看源码边看效果
  3. 在知乎或论坛里试着用Markdown格式回复

当你用熟了之后，你会发现——哇，原来排版可以这么轻松！

-- 展开阅读全文 --