首页 > 代码库 > Markdown学习

Markdown学习

Markdown

1. 简介

“Markdown 是一种轻量级标记语言,它允许人们‘使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档’。”

*轻量级标记语言(lightweight markup language),是一类用简单句法描述简单格式的文本语言。最早出现在无法呈现斜体和粗体文本的只能显示文本的显示器,所以必须开发非常规的方法来表达这些信息,这些格式自然被带入了通常使用文本的电邮通信中。作为一种标记语言,它的语法简单,可方便地使用简单的文本编辑器输入,源文件容易阅读和编辑,原生格式接近自然语言,纯文本有跨平台特性。所谓“轻量级”是相对于其他更丰富格式的标记语言而言的(如富文本格式语言RTF、超文本标记语言HTML、学术界排版语言TeX等)。

2. 学习

参考以下资料:

2.1 基本语法:

- 简书:献给写作者的 Markdown 新手指南

- 阳志平的个人网站:Markdown写作浅谈

- Markdown 语法说明 (简体中文版)

- Github: Markdown Basics, GitHub Flavored Markdown, Writing on GitHub, Mastering Markdown

- Daring Fireball(John Gruber)

- 佐仔志: Markdown 写作教程及语法指南

- 图灵社区: Markdown语法

- 知乎: Markdown 是什么?

 

2.2 其他介绍

- Wikipedia: Markdown

- 简书: Markdown——入门指南

- 少数派: 认识与入门 Markdown(推荐多种Markdown工具)

- mux: Markdown-引领未来科技写作的博客利器(推荐多种Markdown工具)

- Youmeek: Markdown介绍+语法+笔记+常用工具推荐(文章与工具推荐)

 

2.3 在线Markdown工具

- zybuluo.com: Cmd Markdown 简明语法手册 (强烈推荐)

- zybuluo.com: Cmd-在线 Markdown 编辑阅读器 (强烈推荐)

- Dillinger.io

- DaringFireball.net

- stackedit.io (推荐)

- joncom.be

- markable.in

- 马克飞象

 

2.4 Markdown跨平台工具

- Mac: Mou

- Windows: MarkPad, MarkdownPad

- 小众: Markdown 工具补完

 

3. 基本语法练习

3.1 文本

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
以上是标题

这是一个一级标题
===
这是一个二级标题
---
* * *

######内容目录
在段落中填写 `[TOC]` 以显示全文内容的目录结构。
[TOC]
* * *

######删除线
使用 ~~ 表示删除线。
~~这是一段错误的文本。~~
* * *

######无序列表1
- 列表1
- 列表2
* 列表3
* 列表4
+ 列表5
+ 列表6

######有序列表
1. 文本1
2. 文本2
5. 文本3

12345\. 这其实并不是一个有序列表项目

######嵌套列表
1. 列表1
* 文本1
* 文本2
* 文本3
2. 列表2
* 文本1
* 文本2
* 文本3

* * *

######链接与图片
[简书](http://www.jianshu.com/)
![](http://ww3.sinaimg.cn/large/687afc7fjw1dzs5i4iw3uj.jpg)

######图片其他格式:
![Alt text][id]
[id]: http://www.jianshu.com/ "Optional title attribute"

######显示链接中带括号的图片
![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

######自动链接
<http://example.com/>
* * *

######引用
> 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

######多级引用
>会缩进
>>还能嵌套,比上一级缩进更多
>>>再来一条,还能使用其他语法
* * *

######文字效果
*斜体*
_斜体_
**粗体**
__粗体__

* * *

######转义字符
若要输出星号:
\*this text is surrounded by literal asterisks\*
```
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 大括号
[] 中括号
() 小括号
# 井号
+ 加号
- 减号(连字符)
. 句点
! 感叹号
```

* * *

######分割线
a
* * *
b
***
c
- - -
d(连字符,上面要加空行)

---
e(下划线)
___

######空行
* 直接换行
* 加入两个以上空格之后换行

* * *

######表格
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600|
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
* * *

######代码
`
int main () {
cout << "Hello World! " << endl;
}
`

######独立块内容
```
x = 0
x = 2 + 2
what is x
```

* * *

######链接其他形式
[佐仔志][jinbo]
[Jinbo]: https://www.jinbo123.com/

隐式链接标签:
[Google][]
[Google]: http://www.google.com/

Visit [Daring Fireball][] for more information.
[Daring Fireball]: http://daringfireball.net/

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"

* * *

######注脚
使用 [^keyword] 表示注脚。
这是一个注脚[^footnote]的样例。
这是第二个注脚[^footnote2]的样例。
[^footnote]: 这是一个 *注脚* 的 **文本**。
[^footnote2]: 这是另一个 *注脚* 的 **文本**。

 

3.2 效果

 

Markdown学习