MarkDown 语法

[b]Markdown 是什么？[/b]

Markdown 是一种纯文本格式语法的轻量级标记语言。它可以通过简单、易读易写的本文格式生成结构化的HTML 文档。 文件后缀名为 “.md” 、“.markdown”，html 、pdf 为其发布格式。目前很多网站 如 github、Stack Overflow 等网站均支持这种格式。

[b]论 Markdown 的优点？[/b]

兼容 html ，使文档更易读、易写和随便修改

语法种类少，学习成本低

[b]推荐几个在线编辑器或软件？[/b]

Markdown 在线编辑，支持预览：

（1）cmd Markdown

（2）http://mahua.jser.me/ （表格显示有问题）

一．段落、标题、区块代码

1、段落：一个段落由一个以上的行句组成，根据空行的情况可以划分不同的段落，一般的段落不需要空白或者换行缩进。



说明：如你所见，编辑时候，可以一行成段也可以多行成段，但都是以空行划分段落。

2、Markdown 标题：

（1）类 Setext 形式

采用底线 “=” 最高阶标题 ，“-”第二阶标题，“=”和“-”没有数量限制，>=2 即可。



（2）类 Atx 形式

1-6 个 “#” ,对应 1 到 6 阶



Example：

# 一级标题
## 二级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。

2、区块：如果你需要引用一小段别处的句子，那么就要用引用的格式表示引用的区块。比如 文章引用名人名句或者中间插入补充说明。格式为使用 email 的

>

角括号，

只需要在文本前加入

>

这种尖括号（大于号）即可。

Example：

> This is a blockquote.
>
> This is the second paragraph in the blockquote.
>

输出效果：



二． 修辞与强调

Markdown 使用一个星号

*

（斜体强调）、两个星号

**

（粗体强调）和底线

_

（颜色加深强调，一个较浅，两个较深） 来标记需要强调的区段。

Example：

Some of these words *are emphasized*.
Some of these words _are emphasized also_.
Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.

效果显示：



三、列表

1.无序列表可以使用星号

*

、加号

+

、减号

-

作为列表项目标记

Example:

* Candy.
* Gum.
* Booze.

+ Candy.
+ Gum.
+ Booze.

* Candy.
* Gum.
* Booze.

输出效果：



2.有序列表

1. Red
2. Green
3. Blue

输出效果为：



四、项目内添加多段落：进行缩进4个空白或者 1 个 Tab 位

Example：



效果显示:



五、为文章添加文本框：文本文段开头，空出4个空格位或者1个 Tab 键的位置

Example：

这是一个文本框文段

这是第一段落，誤解の渦に飲み込まれていた 陷入误解的漩涡 わからなくなってしまいそう 变得不可捉摸一般 もつれたままで解けないココロ 纠结的无法解开的心结 眠れなくなる一人の夜 辗转反侧的一个人的夜晚 何故か不安になりそうなジエラシー 不觉之间，嫉妒变成了不安 戶惑う昔の關係性 越えて行く 迷惘着的过去的关系，就越过它吧

这是第二段落，久しぶりに会えた 少し伸びた背にドキドキして 久别的相见，稍长的身高还是让人些许心动 あぁアタマの中消えない 啊 在脑中挥散不去 いつも夢に見てた 总是梦见的 優しい声で伝う真實はとても大切なこと 借着温柔的声音传递的那份真实，无比珍贵 愛する人を 二人一緒に 抱きしめて 一同将所爱之人紧抱入怀 迷いの中で叶わないものと 感到迷惑，无法实现的那些事物 諦めて鍵をかけた過去 放弃的被上锁的记忆 不意に笑顏で綴るダイアリー 不觉间被笑容填满的日记

这是第三段落，同じ気持ち分かち合えば 怖くない若是将这份心意共同分担，就不觉可怕 瞳閉じて背伸び 甘いキス交わして始まるの 闭上眼睛，踮起脚开始甜蜜地亲吻 もう我慢なんてできない 我早已按捺不住 古い写真の中 過去と今を緊く思い出は 在旧照片中将过去与现在紧密相连的回忆 ずっと変わらないから 从未改变

效果显示：



六、链接

Markdown 支持两种形式的链接语法：行内 和 参考 两种形式，使用小括号把文字转成超链接。

行内形式是直接在后面用括号直接接上链接。即 链接：

[名称](链接)

Example：



效果显示：



选择性加上 Title 属性

Example:



效果显示输出:



说明：这里的 html 由

<p>This is an <a href="http://example.com/">
example link</a>.</p>

变为

<p>This is an <a href="http://example.com/" title="With a Title">example link</a>.</p>

参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容。

格式为：

[名称1][1], [名称2][2],[名称3][3]
[1]:链接1,”Title1”
[2]:链接2,”Title2”
[3]:链接3,”Title3”

Example :



样式输出：



输出 HTML 为：

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from <a href="http://search.yahoo.com/"
title="Yahoo Search">Yahoo</a> or <a href="http://search.msn.com/"
title="MSN Search">MSN</a>.</p>

title 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写：

I start my morning with a cup of coffee and
[The New York Times][NY Times].

[ny times]: http://www.nytimes.com/[/code] 
输出 HTML 为：

<p>I start my morning with a cup of coffee and
<a href="http://www.nytimes.com/">The New York Times</a>.</p>


效果输出：



七、图片

图片的 Markdown 语法与链接很像

行内形式（title 是选择性的）

![alt text](/path/to/img.jpg "Title")


格式为 :

![名称1][1], ![名称2][2],![名称3][3]
[1]:链接1,”Title1”
[2]:链接2,”Title2”
[3]:链接3,”Title3”


上面两种方法都会输出 HTML 为：

<img src="/path/to/img.jpg" alt="alt text" title="Title" />


效果显示：



八、代码

代码区段：使用反引号 
`
 , 区段内的
&
、
>
 和 
<
 都会自动被转换成HTML实体。

Example：



效果输出：



标记整段的代码域：每行代码进行缩进或者一个 Tab 位

九、表格

Markdown 的表格相对较麻烦(如下)



Example：

| 项目        | 价格   |  数量  |
| --------   | -----:  | :----:  |
| 计算机     | \$1600 |   5     |
| 手机        |   \$12   |   12   |
| 管线        |    \$1    |  234  |


样例效果输出：



说明：其中表示表格文字的位置的符号是冒号“：”，如果没有文字默认靠左。

例如：
----：
 文字靠=靠右；
：----：
文字居中

十、分割线：使用三个星号
***


Example:



十一、代码

1.代码框：使用一对三个反引号 “ 
” 圈住代码域

Example:

* 冒泡法排序

* 比较相邻的元素。如果第一个比第二个大，就交换他们两个。

* 对每一对相邻元素作同样的工作，从开始第一对到结尾的最后一对。在这一点，最后的元素应该会是最大的数。

* 针对所有的元素重复以上的步骤，除了最后一个。</li>

* 持续每次对越来越少的元素重复上面的步骤，直到没有任何一对数字需要比较。

*


* @param numbers

*            需要排序的整型数组

*/

public static void bubbleSort(int[] numbers) {
int temp; // 记录临时中间值
int size = numbers.length; // 数组大小
for (int i = 0; i < size - 1; i++) {
for (int j = i + 1; j < size; j++) {
if (numbers[i] < numbers[j]) { // 交换两数的位置
temp = numbers[i];
numbers[i] = numbers[j];
numbers[j] = temp;
}
}
}


}

效果显示：



2.行内代码块：使用一对反引号
`
,圈住代码部分

Example：

C语言可以使用 
print
 输出

效果显示：



以上是自己常用的语法。