Markdown Tutorals
Markdown介绍:
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。John Gruber 在 2004 年创造了 Markdown 语言,在语法上有很大一部分是跟亚伦·斯沃茨(Aaron Swartz)共同合作的。这个语言的目的是希望大家使用“易于阅读、易于撰写的纯文字格式,并选择性的转换成有效的 XHTML (或是HTML)”。 其中最重要的设计是可读性,也就是说这个语言应该要能直接在字面上的被阅读,而不用被一些格式化指令标记 (像是 RTF 与 HTML)。 因此,它是现行电子邮件标记格式的惯例,虽然它也借鉴了很多早期的标记语言,如:setext、Texile、reStructuredText。 许多网站都使用Markdown 或是其变种,例如:GitHub、reddit、Diaspora、Stack Exchange、OpenStreetMap 与 SourceForge 让用户更利于讨论。
Markdown编辑器
推荐Typora,支持Windows,Linux,MacOS。即时显示,设计精美,体验非常好。
Markdown语法:
推荐简书的献给写作者的 Markdown 新手指南,重要语法收录如下
标题
这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。
而在 Markdown 中,你只需要在文本前面加上
#
即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加#
即可,标题字号相应降低。例如:# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
列表
列表格式也很常用,在 Markdown 中,你只需要在文字前面加上
-
就可以了,例如:- 文本1 - 文本2 - 文本3
如果你希望有序列表, 也可以在文字前面加上
1.
2.
3.
就可以了,例如:1. 文本1 2. 文本2 3. 文本3
注:-、1.和文本之间要保留一个字符的空格。
链接和图片
在 Markdown 中,插入链接不需要其他按钮,你只需要使用
[显示文本](链接地址)
这样的语法即可,例如:[简书](http://www.jianshu.com)
在 Markdown 中,插入图片不需要其他按钮,你只需要使用
![](图片链接地址)
这样的语法即可,例如:![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
注:插入图片的语法和链接的语法很像,只是前面多了一个 !。
引用
在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上
>
就好了,例如:> 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
注:> 和文本之间要保留一个字符的空格。
粗体和斜体
Markdown 的粗体和斜体也非常简单,用两个
*
包含一段文本就是粗体的语法,用一个*
包含一段文本就是斜体的语法。例如:*一盏灯*, 一片昏黄;**一简书**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
最终显示的就是下文,其中「一盏灯」是斜体,「一简书」是粗体:
一盏灯, 一片昏黄;一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
代码引用
需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
如果引用的语句为多行,可以将```置于这段代码的首行和末行。
`单行代码代码` ``` 多行代码 ```
最终显示的就是下文:
单行代码
多行代码
表格
相关代码:
| Tables | Are | Cool | | ------------- |:-------------:| -----:| | col 3 is | right-aligned | $1600 | | col 2 is | centered | $12 | | zebra stripes | are neat | $1 |
显示效果:
Tables Are Cool col 3 is right-aligned $1600 col 2 is centered $12 zebra stripes are neat $1