Markdown 11种基本语法
现在是我在学习Markdown时做的笔记。学完这些Markdown的基本使用已经不成问题。
1. 标题设置(让字体变大,和word的标题意思一样)
在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。
第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)
2. 块注释(blockquote)
通过在文字开头添加“>”表示块注释。(当>和文字之间添加五个blank时,块注释的文字会有变化。)
3. 斜体
将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来
4. 粗体
将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来
5. 无序列表
在文字开头添加(*
, +, and -)实现无序列表。但是要注意在(*
, +, and -)和文字之间需要添加空格。(建议:一个文档中只是用一种无序列表的表示方式)
6. 有序列表
使用数字后面跟上句号。(还要有空格)
7. 链接(Links)
Markdown中有两种方式,实现链接,分别为内联方式和引用方式。
内联方式:This is an [example link](http://example.com/)
。
引用方式: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"
8. 图片(Images)
图片的处理方式和链接的处理方式,非常的类似。
内联方式:![alt text](/path/to/img.jpg "Title")
引用方式:![alt text][id]
[id]
: /path/to/img.jpg "Title"
[1]:data:image/png;base64,
代码方式:<img src="图片路径" height="419" width="470"/>
9. 代码(HTML中所谓的Code)
实现方式有两种:
第一种:简单文字出现一个代码框。使用<blockquote>
。(\不是单引号而是左上角的ESC下面~中的\
)
第二种:大片文字需要实现代码框。使用Tab或四个空格。
10. 脚注(footnote)
实现代码方式如下:
Here's a simple footnote,[^1] and
here's a longer one.[^bignote]
[^1]: This is the first footnote.
[^bignote]: Here's one with multiple paragraphs and code.
实例效果如下:
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
[^1]: This is the first footnote.
[^bignote]: Here's one with multiple paragraphs and code.
11. 下划线
在空白行下方添加三条“-”横线。(前面讲过在文字下方添加“-”,实现的2级标题)
12. 代码段
这里与普通markdown语法有些区别。Java代码示例:
```java
// Java代码
class HelloImportnew {
}
```
效果 =>
// Java代码
class HelloImportnew {
}
类似的,通过将brush参数进行替换可以支持其他语言。
支持的常用语言包括java, xml, shell, html, diff。例如替换为xml:
<pre class=”brush: xml; gutter: true;”>
(其他支持的语言有:actionscript3, applescript, bash, c, csharp, cpp, css, coldfusion, delphi, diff, erlang, groovy, html, javafx, javascript, php, pascal, patch, perl, text, powershell, python, ruby, rails, sql, sass, scala, shell, vb, vbnet, xhtml, xml, xslt)。
</pre>
推荐开启显示行号。如果不需要显示行号,可以设置 gutter: false。
13.表格等复杂情况
markdown的主要设计目标是简洁,通过支持html代码实现对各种复杂情况的处理。
如果需要加入表格等复杂的界面,可以直接嵌入html代码。
表格示例:
<table border=”1″>
<tr>
<td>row 1, cell 1</td>
<td>row 1, cell 2</td>
</tr>
<tr>
<td>row 2, cell 1</td>
<td>row 2, cell 2</td>
</tr>
</table>
效果 =>
row 1, cell 1 | row 1, cell 2 |
row 2, cell 1 | row 2, cell 2 |
不足之处望指正整理来源于网络