简介

本文内容使用 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}
$$

显示效果:

行内公式: math
块状公式:

math

列表

列表分为无序列表和有序列表,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表,有序列表则直接在文字前加 1. 2. 3. 符号要和文字之间加上一个空格

无序列表:
* Red
* Green
* Blue

有序列表:
1. Red
2. Green
3. Blue

显示效果:

  • Red
  • Green
  • Blue
  1. Red
  2. Green
  3. 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 语法冲突,可以在前面添加 \ 符号做转义处理,如:\*