Markdown入门 - 基础语法介绍

 

本质

 

Markdown markdown 是文本，写完之后保存成txt文件，需要用引擎(markdown引擎是用markdown写的)来转化成html才能在浏览器显示。比如官方页面:

http://daringfireball.net/projects/markdown/basics 

markdown的源文件是:

http://daringfireball.net/projects/markdown/basics.txt

推荐一个markdown编辑器，叫MarkdownPad(http://markdownpad.com/)。提供实时预览和常用的菜单操作。

基本语法

 

标题：

markdown支持两种风格语法Setext 和 atx

Setext 如下>>

H1: Hello

      =

H2: Hello

      -

无论“=” 和‘-’多少个，作用和一个是一样的

atx 如下>>

# This is an H1

## This is an H2

...

"#"个数表示标题级别，也可以将标签闭合起来，比如

# This is an H1 ###

左边的"#"个数决定文本的级别，右侧可以任意多个

块级引用：

markdown用">"来开始一段被引用的文本，比如

> This is a markdown text block

> Lazy dog jump over the grey fox

> Lazy dog jump over the grey fox

> Lazy dog jump over the grey fox

块级引用支持懒人写法，只在段落的第一行写一个">", 比如

> This is a markdown text block

   Lazy dog jump over the grey fox

   Lazy dog jump over the grey fox

   Lazy dog jump over the grey fox

块级引用支持引用嵌套，左边“>”的个数表示嵌套的层数，比如

>This is a markdown text block

>> This is a markdown text block

块级引用中支持其他markdown标签，包括标题，列表，代码块

列表：

markdown支持有序和无序两种列表。有序的只支持数字序号，无序的支持"*", "+", "-"。在markdown里写有序刘表的序号是无意义的，它会重新排序，而无序列表不管用哪种符号，显示出来的多是黑点。比如

有序>>

1. First

1. Second

4. Third 

显示出来的是

1. First

2. Second

3. Third 

如果不想让markdown排序，则可以加反斜杠，比如

1\. First

1\. Second

4\. Third 

无序>>

+ First

+ Second

+ Third 

如果要在列表中用块级引用，则需要">"前回车换行，比如

+ First

> block goes here

+ Second

+ Third 

代码块：

markdown中代码块，可以简单的用4个空格或者1个Tab缩进， 比如

        sdfasdfas
            asdfasd
        asdfasdf>
        <div class="asdfas">
            &nbsp; 2004 Foo Corpration
        </div>

在遇到第一个缩进的行时，代码块自动终止。在代码块中所有的特殊字符，比如< > &等都会转化成html实体 (&lt; &gt; &amp;)

如果需要在行内使用代码风格，则可以用"`"包围，即键盘上波浪线那个键。

水平分割线：

可以用连续的三个以上"*"或者"-"，“*”符号之间最多保3个空格，“-”之间最多2个

链接：

markdown支持两种风格：行内，引用

行内>>

This is a [Link](http://g.cn "谷歌")

方括号中的是链接文本，括号中的两个参数，第一个是链接地址href，第二个是title，两者之间用空格隔开。

引用>>

This [LinkName][id] referrence-style link

[id]: http://g.cn 
"谷歌"

这里的"id"相当于一个标识符，对应这个链接的信息，可以为任意字符（包括数字）。标识符用"[]"包围，后面跟链接的href, title。href和title之间用空格或者换行分开，title必须用双引号包围。标识符部分可以写在页面任意地方，不需要紧随[LinkName]。

标识符不区分大小写，比如

[link][a]

[link][A]都将引用

[a] http://g.cn "谷歌"

如过有多个引用值，则取最后一个

比如

[a] http://g.cn "谷歌"

[A] http://baidu.com "百度"

链接将指向最后一个定义的地址。

如果标识符忘了写，则LinkName将作为标识符，比如

[Google][]

那么写链接信息时需要

[Google]: http://g.cn "谷歌"

简单的链接可以用"<>"包围，比如

<http://g.cn>，它将产生一个<a href='http://g.cn'>http://g.cn</a>的链接

强调：

markdown中强调也有加粗(B)和倾斜(I)，有两种方式。

倾斜用“*”或者“_”包围，加粗用“**”或者“__”

图片：

类似链接也有两种风格：行内，引用

行内>>


引用>>

![图片alt文本][id]

这里的id标志符写法同链接的写法

[id]: https://www.google.com.hk/images/nav_logo107.png "图片title"