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-标题.png2. 列表
列表格式也很常用,它可以让你的文稿变得井井有条。在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。
注:-、1.和文字之间要保留一个字符的空格。
2-1-列表.png3. 引用
记录
如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。
在引用文字前加上 > 并与文字保留一个字符的空格,即可。
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-粗体斜体.png5. 链接与图片
链接:在 Markdown 中,插入链接只需要使用 显示文本 即可。
图片:在 Markdown 中,插入图片只需要使用 [图片上传失败...(image-b99d23-1528167562947)]即可。
注:插入图片的语法和链接的语法很像,只是前面多了一个 !
2-4链接与图片.png6. 分割线
分割线的语法只需要另起一行,连续输入三个星号 *** 即可分割两段文字内容。
如图: 2-5-分割线.png7. 表格
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.
10. 脚注
注脚[^6][[6]]8
使用 [^keyword] 表示注脚。
备注:关于注脚好像每个编辑器表示方式会有所不同。
11.待办事宜 Todo 列表
使用带有 [ ] 或 [x] (未完成或已完成)项的列表语法撰写一个待办事宜列表例如:
/ - []things
12. 流程图
支持Markdown语法的软件或网站
-
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]
-
Squarespace 在博客界面下提供 Markdown 编辑器。[22]
-
Stack Overflow 以及其他 Stack Exchange Network 网站使用一种 Markdown 的分支作为它的文章格式化系统。[23][24]
-
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
-
HackMD是一个支持Markdown的在线语法编辑笔记网站,可即时切换源代码与成果查看。
-
纯纯写作 是一种支持使用Markdown语法编辑文本的轻量级文本编辑软件
-
有道云笔记在2016年也开始支持使用markdown来记录
-
简书也开始支持使用markdown来记录
网友评论