MakeDown基础学习笔记

MakeDown基础学习笔记

学习地址

安装包地址【官网】

目标：实现易读易写。

语法颇受到text-to-HTML格式影响

1.兼容HTML，甚至可以不使用Makedown提供的语法，使用Html语法（如<table><tr><td><a><img>等）

2.特殊字符自动转换（HTML中的“<”和“&”必须要使用&lt;和&amp;），但是makedown会帮你完成转换如版权符&copy;输出 ©，如果书写AT&T,makedown会自动转换成AT&amp;T，4 < 5自动转成4 &lt; 5

3.区块元素

3.1段落换行，行尾两个空格、回车或者<br/>

3.2标题支持两种语法类Setext和类atx形式

Setext版本

4 < 5

====

4 &lt; 5

----

atx版本

#4 < 5

##4 &lt; 5

或者

#4 < 5#

##4 &lt; 5##

3.3区块引用

Markdown 标记区块引用是使用类似 email 中用  >  的引用方式。如果你还熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一个区块引用，那会看起来像是你自己先断好行，然后在每行的最前面加上  >  ：

例如

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.> > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse> id sem consectetuer libero luctus adipiscing.

同时也允许你只在段落第一行添加>后面的省略，支持嵌套>>

3.4 列表

*   Red

+   Red

-   Red

1.    red

结果都是一样

如果两行之间有换行的话会转换成<p></p>

1.  This is a list item with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. Donec sit amet nisl. Aliquam semper ipsum sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

代码写在<>里面

如果需要使用数字.需要使用\进行转义

1987. 1986\. What a great season.

4.代码区块

一行前面有四个空格或者一个制表符就是代码块，就会使用<pre><code>标签将代码块包含起来

分割线

连续使用三个以上的符号如***， * * *,-------------

5.区段元素

支持两种形式链接语法，行内式，参考式

行内式使用[]

This is  [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

如果你是要链接到同样主机的资源，你可以使用相对路径：

See my  [About](/about/) page for details.

参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：

This is  [an example][id] reference-style link.

[id]: http://example.com/  "Optional Title Here"

链接内容定义的形式为：

1. 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
2. 接着一个冒号
3. 接着一个以上的空格或制表符
4. 接着链接的网址
5. 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

下面这三种链接的定义都是相同：

[foo]: http://example.com/  "Optional Title Here"

[foo]: http://example.com/  'Optional Title Here'

[foo]: http://example.com/  (Optional Title Here)

[id]: http://example.com/  "Optional Title Here"

[id]: <http://example.com/>  "Optional Title Here"

隐式链接，不区分大小写

[Google][]

[Google]: http://google.com/

6.强调

*as*  

_as_

7.但是如果*和_两边有空格的话会被当成普通字符，需要使用\将去转义

如果要标记一小段行内代码，可以使用反引号引起来

8.图片

两种样式： 行内式和参考式。

行内式

! [Alt text](/path/to/img.jpg)

! [Alt text](/path/to/img.jpg "Optional title")

1. 一个惊叹号 !
2. 接着一个方括号，里面放上图片的替代文字
3. 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。

! [Alt text][id]

[id]: url/to/image  "Optional title attribute"

如果需要设置宽高，使用img标签吧