Markdown 是什么?
Markdown 是一种纯文本格式语法的轻量级标记语言。它可以通过简单、易读易写的本文格式生成结构化的HTML 文档。 文件后缀名为 “.md” 、“.markdown”,html 、pdf 为其发布格式。目前很多网站 如 github、Stack Overflow 等网站均支持这种格式。
论 Markdown 的优点?
- 兼容 html ,使文档更易读、易写和随便修改
- 语法种类少,学习成本低
推荐几个在线编辑器或软件?
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/
输出 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
输出
效果显示:
以上是自己常用的语法。