学习笔记【Markdown】

2018-06-05 本文已影响0人旧灵魂curiosity

Markdown简明学习笔记

Markdown简介

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档”。^[4]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

John Gruber 在 2004 年创造了 Markdown 语言，在语法上有很大一部分是跟亚伦·斯沃茨（Aaron Swartz）共同合作的。这个语言的目的是希望大家使用“易于阅读、易于撰写的纯文字格式，并选择性的转换成有效的XHTML（或是HTML）”。其中最重要的设计是可读性，也就是说这个语言应该要能直接在字面上的被阅读，而不用被一些格式化指令标记（像是RTF与HTML）。因此，它是现行电子邮件标记格式的惯例，虽然它也借鉴了很多早期的标记语言，如：Setext、Texile、reStructuredText。许多网站都使用 Markdown 或是其变种让用户更利于讨论。例如：GitHub、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

Markdown语法

id	name	sex
1	A1	B1
2	A2	B2
3	A3	B3

1. 标题

标题是每篇文章必备而且最常用的格式。

在Markdown中，如果想将一段文字定义为标题，只需要在这段文字前面加上 #，再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题，总共六级，只需要增加 # ，增加一个 # ，标题字号相应降低一级。

2-0-标题.png

2. 列表

列表格式也很常用，它可以让你的文稿变得井井有条。在 Markdown 中，你只需要在文字前面加上 - 就可以了；如果你希望是有序列表，在文字前面加上 1. 2. 3. 即可。

注：-、1.和文字之间要保留一个字符的空格。

2-1-列表.png

3. 引用

记录

如果你需要在文稿中引用一段别处的句子，那么就要用到「引用」格式。

在引用文字前加上 > 并与文字保留一个字符的空格，即可。

2-2引用.png

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ：

This is the first level of quoting.

This is nested blockquote.

Back to the first level.
引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：

这是一个标题。

这是第一行列表项。

这是第二行列表项。

给出一些例子代码：
return shell_exec("echo $input | $markdown_script");

建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以

这是一个普通段落：

这是一个代码区块。

4. 粗体和斜体

Markdown 的粗体和斜体也非常简单：

用两个 * 包含一段文本就是粗体的语法；

用一个 * 包含一段文本就是斜体的语法

我我

2-3-粗体斜体.png

5. 链接与图片

链接：在 Markdown 中，插入链接只需要使用显示文本即可。

图片：在 Markdown 中，插入图片只需要使用 [图片上传失败...(image-b99d23-1528167562947)]即可。

注：插入图片的语法和链接的语法很像，只是前面多了一个！

2-4链接与图片.png

6. 分割线

分割线的语法只需要另起一行，连续输入三个星号 *** 即可分割两段文字内容。

如图：

2-5-分割线.png

7. 表格

id	name	sex
1	A1	B1
2	A2	B2
3	A3	B3

注意表格横线的冒号----：，此表示是否居中。
|---|和|:--|都表示左对齐
|:--:|表示居中对齐
|--"|表示右对齐

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

当你需要在Markdown文稿中键入表格，代码如下：

2-6表格.png

8. 代码区块

建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以

这是一个普通段落：

这是一个代码区块。
12

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

9. 链接

Markdown 支持两种形式的链接语法：行内式和参考式两种形式。

不管是哪一种，链接文字都是用 [方括号] 来标记。

要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可
This is an example inline link.
This link has no title attribute.

image.png

10. 脚注

注脚[^6][[6]]⁸
使用 [^keyword] 表示注脚。
备注：关于注脚好像每个编辑器表示方式会有所不同。

11.待办事宜 Todo 列表

使用带有 [ ] 或 [x] （未完成或已完成）项的列表语法撰写一个待办事宜列表例如：

/ - []things

12. 流程图

支持Markdown语法的软件或网站

Apollo 使用Markdown格式化^[8]
Bitbucket 提供Markdown作为编写项目README文档的其中一种标记语言。^[9]
DIASPORA* 使用Markdown格式化用户发送的消息、评论和对话。^[10]
Drupal 是一个Markdown插件^[11]，始创于2008年。截止2011年11月，已有8000个建站软件使用了该插件。
Ghost 使用Markdown的一个标准版本编辑器来格式化撰写的文章。^[12]
GitHub 使用Markdown的一个分支版本（称为GitHub Flavored Markdown）来格式化评论、消息以及其它内容。^[13]^[14] John Gruber has described this dialect as a "superior variant" for "situations like user-submitted comments".^[15]
G+ Tweaks v1.1151，一个适用于 Google+ 的 Greasemonkey 用户脚本。^[16]
Instiki uses a Markdown extension to wiki syntax. The extended syntax is called Maruku.^[17]
Moodle 提供 Markdown 作为语法标记语言。^[18]
Posterous 提供 Markdown 作为语法标记语言。^[19]
Reddit 的编辑器使用了 Markdown 语法。^[20]
Showoff 使用 Markdown 作为提交的语法。^[21]
Squarespace 在博客界面下提供 Markdown 编辑器。^[22]
Stack Overflow 以及其他 Stack Exchange Network 网站使用一种 Markdown 的分支作为它的文章格式化系统。^[23]^[24]
Tumblr 允许在文章中使用 Markdown。^[25]
Typecho 原生支持Markdown编辑器，实时预览. ^[26]
The WordPress plugin system utilizes a dialect of Markdown in "readme.txt" files submitted by developers, and has plugins for Markdown.^[27]
Second Gear's Elements app for iPhone and iPad gained Markdown capability with its v2 around November of 2010.^[28]
图灵社区使用markdown语法供用户写作电子书.
简书写作网站，支持 Markdown
为知笔记是一种类似印象笔记的笔记软件，支持使用Markdown语法编辑笔记
HackMD是一个支持Markdown的在线语法编辑笔记网站，可即时切换源代码与成果查看。
纯纯写作是一种支持使用Markdown语法编辑文本的轻量级文本编辑软件
有道云笔记在2016年也开始支持使用markdown来记录
简书也开始支持使用markdown来记录