这是一篇 Markdown 学习笔记,简要记录常用 Markdown 语法。
Markdown 是什么?
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)。
它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML (或者 HTML )文档”。
这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
Markdown 同时还是一个由 Gruber 编写的 Perl 脚本:Markdown.pl。
它把用 Markdown 语法编写的内容转换成有效的、结构良好的 XHTML 或 HTML 内容,并将左尖括号('<')和&号替换成它们各自的字符实体引用。
它可以用作单独的脚本,Blosxom 和 Movable Type 的插件又或者 BBEdit 的文本过滤器.
Markdown 也已经被其他人用 Perl 和别的编程语言重新实现,其中一个 Perl 模块放在了 CPAN(Text::Markdown)上。
它基于一个 BSD 风格的许可证分发并可以作为几个内容管理系统的插件。 -- 来自 中文维基百科
Markdown 简要语法
-
段落
一个段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示上看起来像是空行,就被视为空行,
例如有一行只有空白和 Tab,那该行也会被视为空行),一般的段落不需要用空白或换行缩进。 -
区块
区块引用使用尖括号:">",比如:
> This is a blockquote. > > This is the second paragraph in the blockquote. > > ## This is an H2 in a blockquote
-
标题
Markdown 支持两种标题的语法,Setext 和 Atx 形式。
Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),
Atx 形式在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。以下记录均使用
Atx 语法。
标题使用 # 来表示,分别用 1 - 6 个 # 表示 1 - 6 级标题,比如:
```csharp
# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6
+ 强调
强调使用两个 * 来包围需要强调的内容,比如:
```csharp
*Markdown*
如果要加强强调,则:
```csharp
Markdown
+ 分割线
要插入一条分割线有如下几种方式:
```csharp
* * *
- - -
***
-
链接
要为一段文字加上链接可使用如下方式:
[这是一个链接](http://www.google.com "Google 搜索")
+ 图片
要插入一张图片可使用如下方式:
```csharp
![这是一张图片](http://img10.3lian.com/c1/newpic/05/05/12.jpg "这是一张图片")
-
代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
使用 printf()
函数
以上就是一些常用的 *Markdown* 语法,更多 *Markdown* 使用方法请查阅相关文档。
# 参考资料
1. [中文维基百科](http://zh.wikipedia.org/wiki/Markdown "中文维基百科")
2. [GitHub:riku / Markdown-Syntax-CN](https://gitcafe.com/riku/Markdown-Syntax-CN/blob/master "GitHub:riku / Markdown-Syntax-CN")
3. [Markdown: Basics (快速入门)](http://wowubuntu.com/markdown/basic.html "Markdown: Basics (快速入门)")
4. [Markdown 语法说明 (简体中文版)](http://wowubuntu.com/markdown/index.html "Markdown 语法说明 (简体中文版)")