markdown基础语法
写文档就像搭积木,Markdown 就是最省事的那套积木。
1. 标题
用 # 号表示标题,几个 # 就是几级标题,最多六级。
语法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题效果:标题字号依次变小,层级分明。
注意:
#和文字之间要留一个空格,否则有些渲染器不认。
2. 段落与换行
段落之间空一行即可。段内换行在行尾加两个空格,或者直接用 <br>。
语法:
这是第一段。
这是第二段。
第一行(行尾加两个空格)
第二行紧跟着换行3. 文本格式
给文字加粗、倾斜或划掉。
语法:
**这是加粗文字**
*这是斜体文字*
***这是加粗斜体***
~~这是删除线~~
`这是行内代码`效果:
- 加粗:强调重点
- 斜体:辅助说明
删除线:表示废弃行内代码:高亮代码片段
4. 列表
无序列表
用 -、* 或 + 开头,推荐统一用 -。
- 苹果
- 香蕉
- 西瓜
- 黑美人
- 无籽瓜有序列表
用数字加 . 开头。
1. 打开冰箱
2. 把大象放进去
3. 关上冰箱嵌套列表缩进 2 个空格或 1 个 Tab 即可。
5. 链接
给文字加上超链接,点了就跳转。
语法:
[显示文字](https://www.example.com)示例:
[我的 GitHub 主页](https://github.com/XiYang66)带标题的链接(鼠标悬停显示提示):
[我的 GitHub 主页](https://github.com/XiYang66 "点我看看")6. 图片
插入图片,语法和链接很像,前面多一个 !。
语法:
示例:
GitHub 图床 + jsDelivr CDN,图片又快又稳。
7. 引用
引用别人的话或标注备注,用 > 开头。
语法:
> 这是一段引用内容。
>
> 引用里也可以换段。嵌套引用:
> 鲁迅说:
>> 我没说过这句话。8. 代码块
行内代码
用反引号 ` 包裹。
用 `console.log()` 打印日志。多行代码块
用三个反引号 ``` 包裹,可指定语言高亮。
```javascript
function hello() {
console.log('Hello, Markdown!');
}
```支持的语言:javascript、typescript、vue、html、css、python、bash 等。
9. 分割线
用三个或以上的 -、* 或 _,推荐用 ---。
语法:
---10. 表格
用 | 分隔列,用 --- 分隔表头和内容。
语法:
| 姓名 | 技能 | 等级 |
| ------ | ------- | ---- |
| XiYang | Vue3 | 熟练 |
| 张三 | React | 入门 |
| 李四 | Angular | 精通 || 姓名 | 技能 | 等级 |
|---|---|---|
| XiYang | Vue3 | 熟练 |
| 张三 | React | 入门 |
| 李四 | Angular | 精通 |
| 对齐方式: |
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 左 | 中 | 右 || 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 左 | 中 | 右 |
11. 任务列表
创建带勾选框的待办事项。
语法:
- [x] 搭建 GitHub 图床
- [x] 配置 jsDelivr CDN
- [ ] 写完这篇文档
- [ ] 出门吃顿好的效果:
12. 转义字符
Markdown 中有些符号有特殊含义,想原样显示就加 \ 转义。
语法:
\* 这不是斜体 \*
\# 这不是标题
\` 这不是代码需要转义的符号:
| 符号 | 含义 |
|---|---|
\ | 反斜杠 |
* | 斜体/加粗 |
_ | 斜体/加粗 |
# | 标题 |
> | 引用 |
[] | 链接 |
() | 链接地址 |
` | 代码 |
| ` | ` |
13. 删除线与脚注(扩展语法)
部分平台支持,GitHub、Typora 等均兼容。
删除线
~~这段话作废了~~脚注
这是一句话[^1],需要补充说明。
[^1]: 这是脚注的详细内容。速查总结
| 语法 | 作用 | 写法示例 |
|---|---|---|
# | 标题 | ## 二级标题 |
**文字** | 加粗 | **重要** |
*文字* | 斜体 | 备注 |
~~文字~~ | 删除线 | ~~废弃~~ |
- 文字 | 无序列表 | - 苹果 |
1. 文字 | 有序列表 | 1. 第一步 |
[文字](url) | 链接 | [GitHub](url) |
 | 图片 |  |
> 文字 | 引用 | > 他说 |
``` | 代码块 | ```js |
--- | 分割线 | --- |
| 表格 | | 表格 | | A | B | |
- [x] | 任务列表 | - [x] 完成 |
写文档不用死记硬背,用多了自然就熟了。遇到不确定的,翻翻这篇就行。
