markdown语法使用

Markdown是什么

Markdown是一种轻量级标记语言，它以纯文本形式(易读、易写、易更改)编写文档，并最终以HTML格式发布。
Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

Overview

它由Aaron Swartz和John Gruber共同设计，Aaron Swartz于2013年1月11日自杀,有着开挂一般人生经历的程序员。维基百科对他的介绍是：软件工程师、作家、政治组织者、互联网活动家、维基百科人。
他有着足以让你跪拜的人生经历：

• 14岁参与RSS 1.0规格标准的制订。
• 2004年入读斯坦福，之后退学。
• 2005年创建Infogami，之后与Reddit合并成为其合伙人。
• 2010年创立求进会（Demand Progress），积极参与禁止网络盗版法案（SOPA）活动， 最终该提案被撤回。
• 2011年7月19日，因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
• 2013年1月自杀身亡。
  

基本构成

分段和换行

段落就是一个或多个连续的文本行。在markdown源代码中，段落由两个或多个空行分隔。你只需要一个空行(按“Enter”一次)来创建一个新的段落。

标题

在标题名称前面输入#号，可以创建标题
标题使用 1-6 级 (#) ,例如:

>
># 这是标题1
>##  这是标题2
>### 这是标题3
>####  这是标题4
>#####  这是标题5
>######  这是标题6

引用

Markdown使用电子邮件风格的>字符进行块引号。它们表现为:

> This is a blockquote with two paragraphs. This is first paragraph.
> This is second pragraph. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.

在引号内容后面输入’ > '将生成一个引号块

列表

输入 * list item 1 will create an unordered list - the * symbol can be replace with + or -.

Input 1. list item 1 will create an ordered list - their markdown source code is as follows:

## un-ordered list
*   Red
*   Green
*   Blue

## ordered list
1.  Red
2. 	Green
3.	Blue

任务列表

任务列表是标记为 - [ ] 或 -[x] (不完整或已完成)的列表。例如:

- [ ] incomplete
- [x] completed

您可以通过单击项目前的复选框来更改完整/不完整状态。

代码高亮

输入 ``` ，在 ``` 后面添加语言名称:

样例：
```c
#inlcude
int main()
{

    printf("getup");
}

数学公式

您可以使用MathJax渲染LaTeX数学表达式。

要添加一个数学表达式，输入’ $$ '。这将触发一个接受Tex/LaTex源的输入字段。例如:

$${\mathbf{V}}_1\times {\mathbf{V}}_2=\left|\begin{array}{ccc}\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{array}\right|$$

In the markdown source file, the math block is a LaTeX expression wrapped by a pair of ‘$$’ marks:

$$
\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}
$$

获取更多关于latex的信息 点击此处.

表格

输入 |一级标题 | 二级标题 | 创建表格

创建表之后，将焦点放在该表上将打开该表的工具栏，您可以在其中调整该表的大小、对齐或删除该表。您还可以使用上下文菜单复制和添加/删除单独的列/行。

In markdown source code, they look like:

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

还可以在表中包括链接、粗体、斜体或删除线等内联标记。

最后，通过在标题行中包含冒号(’:’)，你可以定义该列中的文本为左对齐、右对齐或居中对齐:

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |

最左边的冒号表示左对齐的列;最右边的冒号表示右对齐的列;两边的冒号表示列居中。

脚注

你可以在这里创建一个脚注[^footnote].

[^footnote]: 这段话自动生成 **footnote**.

划线

在空行中输入’ *** ‘或’——‘并按下’ return '将绘制一条水平线。

---

前页眉

在文章顶部输入---，生成页眉

目录 (TOC)

输入@[toc]。这将创建一个“目录”部分。TOC从文档中提取所有的标题，当您向文档添加内容时，它的内容会自动更新。

行内元素

Span元素将在输入后立即解析和呈现。将光标移动到这些span元素的中间将把这些元素扩展为markdown源。下面是对每个span元素的语法解释。

链接

Markdown支持两种样式的链接:内联链接和引用链接。
在这两种样式中，链接文本都由[方括号]分隔。
要创建内联链接，请在链接文本的右方括号后紧接一组常规圆括号。在括号内，将URL放在你想要链接指向的地方，以及一个可选的链接标题，用引号括起来。例如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

这是 样例 超链接

[链接](https://blog.csdn.net/qq_43475285) 没有文本.

网络连接

Yo你可以设置href为头文件**，这将创建一个书签，允许你在点击后跳转到该区域。例如:

Ctrl + Click This link 将会跳转到Block Elements.

文献链接

引用样式的链接使用第二组方括号，你可以在其中放置一个你选择的标签来识别链接:

这是一个 [样例][id] .

点击这里会跳转到下面写的网址中

[id]: https://blog.csdn.net/qq_43475285  "网站内容"

图片

图片和链接有相似的语法，但是它们需要额外的’ !’ char在链接开始前。插入图像的语法如下所示:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

强调

Markdown treats asterisks (*) and underscores (_) as indicators of emphasis. Text wrapped with one * or _ will be wrapped with an HTML tag. E.g:
Markdown把星号(“*”)和下划线(“_”)当作强调的标志。用’ * ‘或’ _ '包装的文本将被HTML标签包装。例句:

*强调*

_强调_

加粗

A double * or _ will cause its enclosed contents to be wrapped with an HTML tag, e.g:

**加粗**

__加粗__

output:

加粗

加粗

删除线

GFM添加了创建删除线文本的语法，这在标准的Markdown中是缺失的。

~~删除.~~ becomes 删除.

下划线

下划线 变成 下划线.

Emoji 表情

:smile:

高亮

使用’ == '来换行突出显示内容。例如:“= =高亮= =”。

高亮

HTML

您可以使用HTML来样式化纯Markdown不支持的内容。例如，使用this text is red来添加带有红色的文本。

视频

你可以使用 标签.例如:

---

参考文档：https://github.com/younghz/Markdown