简介
本文内容使用 Markdown 撰写
Markdown 是一种轻量级的 「标记语言」,通过简单的标记,可以使普通文本内容具有一定的格式。语法简洁明了、学习容易,而且功能比纯文本更强,因此被广大的写作爱好者、撰稿者使用。很多博客、文字都使用 Markdown,学习成本低、熟悉语法规则后可以一劳永逸。
- 专注文字内容而不是排版样式
- 轻松导出其他文件格式:PDF,HTML,WORD
- 纯文本内容,可以使用任意文本编辑器,当成 txt 打开
- 可读性好、样式直观、学习成本低
- 易传播分享:Markdown 文件可以轻易分享到各种博客平台、文章分享平台上
语法规则
多级标题
语法:
# 一级标题
## 二级标题
### 三级标题
文章最常用的格式就是标题,在前面添加 1~6 个'#'符号,对应 1~6 级标题,不同级别字体大小不一样
样式
加粗
语法:**加粗文字 1** __加粗文字 2__
在文字前后添加两个 * 或者 _(下划线)即可,显示效果:加粗文字 1 加粗文字 2
斜体
语法:*斜体文字 1* _斜体文字 2_
在文字前后添加一个 * 或者 _(下划线)即可,显示效果:斜体文字 1 斜体文字 2
删除线
~~删除文字~~
在需要删除的文字前后添加两个 ~ 即可,显示效果:删除文字
链接和图片
语法: [hackerTalk](https://hackertalk.net)
显示效果:hackerTalk
图片语法和链接语法类似,只是多了一个感叹号:
![可选的描述文字](https://image.hackertalk.net/filters:format(webp)/u/cover/0)
显示效果:
分割线
下面是分割线语法:
---
***
显示效果:
引用块
> 这是单行引用(注意行距)
>
> 如果这一行很长的话,就是长引用,比如这样:aabcdefghijklmnopqrstuvwxyz 0123456789 aabcdefghijklmnopqrstuvwxyz 0123456789
如果需要引用来自其他文献的文字片段,在文字前添加 > 符号即可,显示效果:
这是单行引用(注意行距)
如果这一行很长的话,就是长引用,比如这样:aabcdefghijklmnopqrstuvwxyz 0123456789 aabcdefghijklmnopqrstuvwxyz 0123456789
代码
行内代码
`string.length()` `string.charAt(0)`
使用单个 ` 符号包围即可,显示效果:string.length()
string.charAt(0)
块状代码
在文档中导入代码片段可以使用连续 3 个 ` 包围代码,Markdown 可以提供代码高亮功能,显示更为清晰,语法如下:
```javascript
function test() {
console.log("hello word");
}
```
显示效果:
function test() {
console.log('hello word');
}
数学公式(Latex 语法)
行内公式: $E = mc^2$
块状公式:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$
显示效果:
行内公式:
块状公式:
列表
列表分为无序列表和有序列表,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表,有序列表则直接在文字前加 1. 2. 3. 符号要和文字之间加上一个空格
无序列表:
* Red
* Green
* Blue
有序列表:
1. Red
2. Green
3. Blue
显示效果:
- Red
- Green
- Blue
- Red
- Green
- Blue
表格
| 日期 | 星期 & 天气 | 任务 |
| --------- | --------------- | -------- |
| 2019-1-1 | 星期二 晴 | 上班 |
| 2019-1-2 | 星期三 大到暴雨 | 睡个大觉 |
显示效果:
日期 | 星期 & 天气 | 任务 |
---|---|---|
2019-1-1 | 星期二 晴 | 上班 |
2019-1-2 | 星期三 大到暴雨 | 睡个大觉 |
添加冒号:设置对齐方式(左对齐, 右对齐, 居中)
| 日期 | 星期 & 天气 | 任务 |
| :--------- | :---------------: | --------: |
| 2019-1-1 | 星期二 晴 | 上班 |
| 2019-1-2 | 星期三 大到暴雨 | 睡个大觉 |
显示效果:
日期 | 星期 & 天气 | 任务 |
---|---|---|
2019-1-1 | 星期二 晴 | 上班 |
2019-1-2 | 星期三 大到暴雨 | 睡个大觉 |
HTML 语法
由于 html 语法有很多不确定性、兼容问题、安全问题,平台不做支持。
转义符
一些符号可能会和 markdown 语法冲突,可以在前面添加 \ 符号做转义处理,如:\*