从零开始用Markdown写博客完整教程包括常用语法和发布技巧

说实话，我第一次接触Markdown的时候也是懵的，看着满屏的*和#，心里直犯嘀咕：这玩意儿真能写博客？但后来我发现，这其实是写作者最省心的工具之一，不用挑字体、不用调排版，专心写内容就行。今天咱们就从头到尾，把Markdown这块儿彻底讲透。

先搞清楚：Markdown到底是啥？

Markdown是一种轻量级标记语言，由John Gruber在2004年创建。说白了，它就是把一些简单的符号（比如#、*、-）加上普通文字，就能自动变成标题、加粗、列表这些富文本格式。

你看这行：

# 这是一级标题

渲染出来就是：

这是一级标题

是不是特别直观？不需要去点按钮、拖拽菜单，敲几行符号，页面自动就漂亮了。这对写作者来说，等于把”写作”和”排版”两件事合二为一，效率直接翻倍。

为什么选Markdown写博客？

我见过太多新手在Word里写博客，结果发出去之后排版乱成一团，图片对不齐、字号忽大忽小。用Markdown就不会有这种烦恼，因为你写的每一行代码，都会在发布时自动渲染成标准格式。

更重要的是，Markdown文件是纯文本格式（.md或.txt），不管用什么平台、什么编辑器，打开都能正常显示。你今天用Typora写，明天搬到掘金、知乎、WordPress，内容完全不差。

如果你现在还不信，可以先看看下面这份最常用的语法对照表，看完你就知道它有多简单了。

Markdown基础语法大全

标题

用#号来定义标题，#的数量代表级别，最多支持六级：

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

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

写博客的时候，一级标题一般用作文章主标题，二级和三级用作章节标题，这样就够用了，别搞太多层级，读者看着晕。

段落与换行

在Markdown里，两个回车就是一个新段落：

第一段内容，说完这事儿歇一下。

第二段内容，另起一段，中间空了一行。

渲染效果：

第一段内容，说完这事儿歇一下。

第二段内容，另起一段，中间空了一行。

如果想强制换行（不换段落），在行尾加两个空格再回车，或者直接用<br>标签：

第一行内容  <--- 这里有两个空格
第二行内容

加粗和斜体

这个最常用，加粗用两个星号，斜体用一个星号：

**这段文字会加粗显示**
*这段文字是斜体*
***这段文字又加粗又斜体***

效果：

这段文字会加粗显示 这段文字是斜体 这段文字又加粗又斜体

还有一种方式是用下划线，效果一样：

__加粗__
_斜体_
___又加粗又斜体___

引用

用>符号来写引用，可以嵌套：

> 这是一级引用，类似blockquote。
> 
> > 这是二级引用，嵌套了一层。

效果：

这是一级引用，类似blockquote。

这是二级引用，嵌套了一层。

写博客的时候，引用非常适合用来引用别人的观点、金句，或者补充说明。

列表

列表分有序和无序两种，区别就是一个用数字、一个用符号。

无序列表用-、+或*都可以：

- 苹果
- 香蕉
- 橙子

或

* 苹果
* 香蕉
* 橙子

效果：

苹果
香蕉
橙子

有序列表用数字加点：

1. 第一步：注册账号
2. 第二步：选择主题
3. 第三步：开始写作

效果：

第一步：注册账号
第二步：选择主题
第三步：开始写作

列表还可以嵌套，缩进两个空格就行：

- 水果
  - 苹果
  - 香蕉
- 蔬菜
  - 白菜
  - 萝卜

效果：

水果
- 苹果
- 香蕉
蔬菜
- 白菜
- 萝卜

代码

代码这块儿是Markdown的强项，分行内代码和代码块两种。

行内代码用反引号`包起来：

把变量命名为`userAge`更清晰。

效果：把变量命名为userAge更清晰。

代码块用三个反引号 “`包裹，还可以指定语言类型，方便高亮：

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet("小明"));
```

效果：

function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet("小明"));

支持的代码语言非常多，常见的有：

语言	标识
JavaScript	`javascript` 或 `js`
Python	`python`
Java	`java`
C++	`cpp`
HTML	`html`
CSS	`css`
JSON	`json`
SQL	`sql`
Bash	`bash`

链接和图片

链接和图片的语法很相似，图片多了一个!前缀：

[点击访问知乎](https://www.zhihu.com)
![Markdown Logo](https://markdown-here.com/img/icon256.png)

效果：

点击访问知乎 Markdown Logo

链接和图片都支持设置标题提示，鼠标悬停时显示：

[点击访问知乎](https://www.zhihu.com "去知乎逛逛")
![Markdown Logo](https://markdown-here.com/img/icon256.png "Logo图片")

如果你的图片存在本地，发布平台一般支持直接粘贴或上传。但如果博客平台不支持外链，你可以先把图片传到图床（比如SM.MS、Imgur、又拍云），再在Markdown里用上面的语法引用。

表格

表格在技术博客里特别常用，语法如下：

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

效果：

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

冒号可以用来控制对齐方式：

| 姓名 | 年龄 | 城市 |
|:-----|:----:|-----:|
| 小明 | 25   | 北京 |
| 小红 | 23   | 上海 |
| 小刚 | 27   | 广州 |

效果：

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

左边冒号：左对齐
两边冒号：居中
右边冒号：右对齐

分割线

用三个或以上-或*来创建水平分割线：

---

或

***

效果：

转义字符

有些特殊符号你想原样显示，不想让它被解析成格式，就在前面加反斜杠\：

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

效果：

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

动手写：你的第一篇文章

理论看完了，来实战一下吧。假设你要写一篇关于”如何学好编程”的博客，用Markdown来写大概是这样的：

# 如何从零开始学好编程

## 为什么要学编程

编程是一门非常有用的技能，它能帮助你：

- 提高逻辑思维
- 自动化重复工作
- 打开高薪职业的大门

## 第一步：选一门语言

初学者推荐从 **Python** 入手，它的语法接近自然语言，上手快。

```python
# 你的第一行代码
print("Hello, World!")

第二步：动手实践

光看不动手，永远学不会。建议每天至少写30分钟代码，哪怕只是复制粘贴然后改一改。

第三步：做个小项目

学完基础语法后，试着做一个待办事项清单或者简单的计算器，把学到的东西用起来。

编程不是背出来的，是写出来的。

总结

编程学习没有捷径，但有方法：选语言 → 动手写 → 做项目 → 持续练。只要坚持，三个月后你也能写出自己的第一个小程序。


把它复制到任何支持Markdown的编辑器里预览，你就能看到一个排版清晰的文章了。

---

## 工具推荐：用什么来写Markdown？

工欲善其事，必先利其器。选对工具，写博客能快好几倍。

### 桌面端编辑器

**Typora**（推荐新手）

Typora是目前最流行的所见即所得Markdown编辑器，你输入符号的同时，页面自动渲染出格式，像写Word一样简单，但又保留了Markdown的全部功能。官网：typora.io

**VS Code**（程序员首选）

Visual Studio Code是一款免费开源的代码编辑器，安装了Markdown插件之后，左边写代码，右边实时预览，功能非常强大。

安装步骤：
1. 下载安装 VS Code：code.visualstudio.com
2. 打开后点击左侧扩展商店（四个方块图标）
3. 搜索"Markdown Preview Enhanced"并安装
4. 打开`.md`文件，按`Ctrl+Shift+V`即可预览

**Obsidian**（知识管理神器）

Obsidian不仅支持Markdown，还有双向链接、知识图谱等功能，适合长期积累素材和搭建个人知识库。官网：obsidian.md

### 在线编辑器

如果你不想装软件，直接用在线的也行：

- **StackEdit**（stackedit.io）—— 功能全面，支持同步到Google Drive和GitHub
- **Dillinger**（dillinger.io）—— 简洁好用，打开就能写
- **码字工具**（mztools.cn）—— 国内访问快，有字数统计

---

## 发布到各大平台

写好了文章，接下来就是发布了。不同平台对Markdown的支持程度不一样，这里给你梳理一下主流平台的使用方法。

### 掘金

掘金对Markdown支持最好，基本原汁原味。写作页面右上角有个"Markdown"切换按钮，点一下就能切换到源码模式。

发布技巧：
- 标题建议控制在30字以内
- 正文用`##`做章节标题，层次清晰
- 代码块记得标注语言类型
- 适当加粗关键句，提升阅读体验

### 知乎

知乎的Markdown支持相对有限，但基本语法都能用。写作时切换到"源码模式"（按`Ctrl+Shift+V`或点编辑器左下角的代码图标），然后粘贴Markdown内容即可。

注意：知乎对表格的支持不太好，建议简单表格用文字描述代替，复杂的用图片展示。

### CSDN

CSDN编辑器内置了Markdown支持，直接在"Markdown编辑"模式下写作，效果还不错。但要注意，CSDN的预览和最终显示有时候会有细微差异，发布前务必预览检查一下。

### 个人博客（Hexo / Hugo / WordPress）

如果你有自己的博客网站，那就完全自由了。

**Hexo** 是一个静态博客生成器，配合Next、Butterfly等主题，效果非常专业。

安装Hexo（需要Node.js环境）：

```bash
# 全局安装Hexo
npm install -g hexo-cli

# 初始化博客文件夹
hexo init my-blog
cd my-blog

# 安装依赖
npm install

# 启动本地预览
hexo server

然后在source/_posts文件夹下新建.md文件，写入你的Markdown内容，执行hexo generate生成静态页面，再hexo deploy部署到服务器即可。

WordPress 从5.0版本开始内置了Gutenberg编辑器，也支持纯Markdown输入。在写文章时切换到”代码编辑器”模式，粘贴Markdown内容就能自动渲染。

提升写作效率的小技巧

写了一段时间之后，你会发现有些重复性工作很烦人。下面这些技巧能帮你省不少时间。

用缩写模板加速写作

每篇文章的结构其实差不多，可以提前准备一些模板：

# {文章标题}

## 背景
{为什么写这篇文章}

## 正文
### 第一部分
{内容}

### 第二部分
{内容}

## 总结
{一句话总结}

把这个存到你的编辑器里，每次新建文章直接套用，省掉搭框架的时间。

常用命令/代码段收藏

把常用的代码片段、语法用法存成一个文件，比如叫markdown-cheatsheet.md，需要的时候直接复制粘贴，不用每次都现查。

快捷键熟记

操作	快捷键
加粗	`Ctrl+B`
斜体	`Ctrl+I`
插入链接	`Ctrl+K`
插入图片	`Ctrl+Shift+I`
切换预览	`Ctrl+Shift+V`
保存	`Ctrl+S`

这些快捷键在Typora和VS Code里都通用，记熟之后手不离键盘，写作流畅度提升明显。

图片管理

博客里的图片最好统一管理。可以建一个assets/文件夹，所有图片放在里面，引用时用相对路径：

![图片描述](./assets/截图1.png)

这样搬家的时候整文件夹复制过去就行，不会丢图。

常见坑和避坑指南

新手写Markdown博客，经常会踩一些坑。我帮你提前排雷。

坑一：中文标点与英文标点混用

Markdown的语法符号必须用英文半角，比如#、*、`、-。如果你用了中文的＃或＊，渲染会失败。

错误示例：

＃ 这是标题   ← 中文符号，无效
＊这是加粗＊   ← 中文符号，无效

正确示例：

# 这是标题
**这是加粗**

坑二：列表缩进不对导致格式错乱

列表嵌套时，子项必须比父项多缩进两个空格，少一个都不行：

- 正确：缩进两个空格
  - 子项
    - 孙子项

- 错误：缩进不够
 - 子项   ← 只有一个空格，格式乱了

坑三：图片路径写错

图片路径一定要检查是否正确，特别是从Windows复制到Linux服务器的时候，路径分隔符\\会变成/，记得统一用正斜杠。

坑四：代码块没有指定语言

不指定语言的话，代码块没有高亮，看起来像纯文本，阅读体验差很多。养成习惯，每次都加上语言类型：

```python
print("你好")

”`

结语：坚持写，自然就熟了

说实话，Markdown的语法不多，大概十几个常用符号就能应付90%的场景。真正的难点不在于记住语法，而在于写。

我建议你从今天开始，选一个平台（掘金、知乎、CSDN都行），写一篇短文试试。不用追求完美，先写完，再逐步优化。写个十篇八篇之后，你会发现自己已经离不开Markdown了——写起来顺手，排版自动整齐，内容想改随时改，特别自由。

如果你在写作过程中遇到任何具体问题，比如”为什么表格渲染不出来”或者”图片显示不了”，随时可以来问我，咱们一起解决。写作这条路，一个人走有时候挺闷的，有个能讨论的人，进步会快很多。

加油，期待看到你的第一篇文章！