这篇教程写给完全没用过 Markdown 的人。它是写字的一种"格式约定":用几个普通符号告诉电脑"这句是标题、这个词要加粗"——学会它,你在本站写文章、发评论都能排出漂亮的版面。全文每一节都是"这样打 → 出这个效果",跟着敲一遍就会。
一、标题:行首加井号
想写标题,在行首打 #(井号)再加一个空格。井号越多,标题越小:
# 一级标题(最大,一般不用——文章标题系统自动加)
## 二级标题
### 三级标题
二、段落与换行
直接写字就是正文,空一行就分成两段。想在段落内换行,在行尾留两个空格。
这是第一段。
这是第二段。
三、给文字加效果
| 你想要的效果 | 怎么打 | 说明 |
|---|---|---|
| 粗体 | 两个星号夹住文字 | **粗体** 的效果 |
| 斜体 | 一个星号夹住文字 | *斜体* 的效果 |
| 两个波浪线夹住文字 | ~~删除线~~ 的效果 | |
行内代码 | 反引号夹住文字(反引号键在键盘 Tab 上方) | 会变成灰底等宽字体 |
四、列表
无序列表:行首 - (减号+空格),每行一项:
- 苹果
- 香蕉
- 西瓜
- 苹果
- 香蕉
- 西瓜
有序列表:行首 1. 2. ,数字自己写:
1. 注册账号
2. 登录
3. 开始写文章
- 注册账号
- 登录
- 开始写文章
嵌套列表:子项前面加 4 个空格:
- 水果
- 苹果
- 香蕉
- 饮料
- 可乐
- 水果
- 苹果
- 香蕉
- 饮料
- 可乐
五、引用:竖线缩进
行首加 > (大于号+空格),常用来放别人说的话或补充说明:
> 这是一条引用,会在左侧显示一条竖线。
这是一条引用,会在左侧显示一条竖线。
六、代码块:整段代码原样显示
在代码的上一行和下一行,各单独打三个反引号(反引号键在键盘 Tab 上方、数字 1 左边,连按三次)。中间的内容会原样显示,任何符号都不再生效——上面每一节的"这样打"示例框就是这么做的:
print("hello world")
七、链接
行内链接(放在句子里):中括号写文字、圆括号写网址:
详细说明见[这篇文章](/posts/shzu-schedule)。
详细说明见这篇文章。
独立链接卡片:让链接自己占一行,会自动变成带图标的卡片(很适合放下载地址、源码地址):
八、图片
叹号 + 中括号写说明 + 圆括号写图片地址。在本站编辑器里不用手写——点工具栏的图片按钮直接上传,自动插入。
九、表格
用竖线 | 分列,第二行的短横线 --- 表示表头分隔。复制下面的模板改就行:
| 姓名 | 分数 |
| --- | --- |
| 小明 | 90 |
| 小红 | 95 |
| 姓名 | 分数 |
|---|---|
| 小明 | 90 |
| 小红 | 95 |
十、分割线
单独一行三个减号 ---,生成一条分隔线:
速查表(收藏这行就够了)
| 语法 | 怎么打 |
|---|---|
| 标题 | 行首 # / ## / ### |
| 粗体 | 两个星号夹文字 |
| 斜体 | 一个星号夹文字 |
| 删除线 | 两个波浪线夹文字 |
| 行内代码 | 一个反引号夹文字 |
| 无序列表 | 行首 - 项 |
| 有序列表 | 行首 1. 项 |
| 嵌套项 | 缩进 4 空格 |
| 引用 | 行首 > 内容 |
| 代码块 | 上下各一行三个反引号 |
| 链接 | [文字](地址) |
| 图片 |  |
| 表格 | 竖线分列 + --- 行 |
| 分割线 | 单独一行 --- |
开始练习
最简单的入门方式:打开写文章页面,右边是实时预览——左边打字,右边立刻看到效果,随便试,试错没有任何成本。工具栏上的每个按钮都会帮你自动插入对应语法,忘了打法就点按钮。
本教程覆盖本站支持的全部 Markdown 语法。有任何问题欢迎在评论区提问。
m1SuHub