Markdown
What is Markdown?
Markdown 是一种轻量级的文本标记写法（markup language），广泛用于 GitHub，博客等各种 Web 网站。Markdown guide 网站源码：GitHub，网站教程已经写的很好，本文借鉴于此，做个笔记
原理
处理 markdown 文件的应用程序使用一种称为 Markdown 处理器，也叫解析器或者实现的东西将该格式文件转换为 HTML, 再通过 Web 浏览器进行显示
Why use Markdown?
easy to learn, use, light-weight
place emphasis on content, not mark format
can be transfer into html or other format, easy for distribution
微软的 word 等软件太生草了，写的时候纠结于格式，打开还要下载特定的软件，不适合到处纷发这种特性，Markdown 注重的是写作的内容而不是格式问题
Markdown 可以内嵌 HTML 语法，许多网站内嵌 Markdown 处理器，适合现在 Web 浏览器显示
生成 GitHub Pages
GitHub 为 Jekyll 提供免费的网页 host 服务
GitHub Pages uses Jekyll as the backend for its free website creation service
如果您想使用内容管理系统（CMS）来为网站提供动力，请查看Ghost。这是一个免费的开源博客平台，具有出色的Markdown编辑器。如果您是WordPress用户，您将很高兴知道WordPress.com上托管的网站有Markdown支持。自托管的WordPress网站可以使用Jetpack插件。
How to use Markdown?
Basic Syntax
标题
1
2
3
4
5
6
7
8# 标题
or
<h1></h1>
<h2></h2>
段落之间空行，且不要缩进。用
<p></p>
<br>粗体
1
2
3**bold**
or
<strong></strong>斜体
1
2
3*italic*
or
<em></em>块引用
1
2
3
4
5
6> blockquote
>> two
之间空行
> ###
>
> -有序列表
1
2
3
4
5
6
7
8
9
10
111. ordered list
2. two
<ol>
<li></li>
<li></li>
</ol>
1968\. 转义
在列表中通过缩进四个空格来添加其他元素无序列表
1
2
3
4
5- unordered list
<ul>
<li></li>
<li></li>
</ul>code
1
2
3`code`
<code></code>
``Use `code` in your Markdown file.``水平线 horizontal rule
1
2---
之间空行链接
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15[title](link address "悬停提示")
直接显示链接
<https://www.markdownguide.org>
<fake@example.com>
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).
<a href="" title="">link</a>
与原来的链接一样，1 为 1 的链接
[hobbit-hole][1]
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle "Hobbit lifestyles"
Markdown 中链接如果有空格用%20代替，否则用 HTML 的 tag图片
1
2
3
[](https://www.flickr.com/photos/)
块级元素之间分行，尽量不要缩进 tag，会干扰格式，且不能在块级元素使用 Markdown 语法，不会工作
\进行转义
Extended Syntax
GitHub Flavored Markdown (GFM)
表格 table
1
2
3
4
5| class | name | test |
|:------|:----:|-----:|
| 1 | 2 | \| |
| 可以用 | 表中可以用 HTML 语法加入 list代码块 fenced code block
1
2
3
4
5
6
7```json
{
"firstname": "John",
"lastname": "Smith",
"age": 25
}
\`\`\`脚注 footnote
1
2
3
4
5
6
7
8
9
10
11
12可以添加标识符，但实际上仍然是按顺序标号
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
[^1]: This is the first footnote.
[^bignote]: Here's one with multiple paragraphs and code.
Indent paragraphs to include them in the footnote.
`{ my code }`
Add as many paragraphs as you like.标题 ID heading ID
1
2
3
4
5### My Great Heading {#custom-id}
<h3 id="custom-id">My Great Heading</h3>
[Heading IDs](#heading-ids)
<a href="#heading-ids">Heading IDs</a>
[Heading IDs](https://www.markdownguide.org/extended-syntax#heading-ids)定义列表 definition list
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15term
: definitionFirst Term
: This is the definition of the first term.
Second Term
: This is one definition of the second term.
: This is another definition of the second term.
<dl>
<dt>First Term</dt>
<dd>This is the definition of the first term.</dd>
<dt>Second Term</dt>
<dd>This is one definition of the second term. </dd>
<dd>This is another definition of the second term.</dd>
</dl>删除线 strikethrough
1
~~The world is flat.~~
任务列表 task list
1
2- [x]
- [ ]表情 emoji
1
That is so funny! :joy:
高亮 highlight
1
2I need to highlight these ==very important words==.
<mark></mark>下标 subscript
1
2H~2~0
<sub>2</sub>上标 superscript
1
2X^2^
<sup>2</sup>
diable automatic URL linking
1 | `http://www.example.com` |
Hacks
1 | # 下划线 underline |