MarkDown 语法

Markdown 是什么?

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

论 Markdown 的优点?
  1. 兼容 html ,使文档更易读、易写和随便修改
  2. 语法种类少,学习成本低
推荐几个在线编辑器或软件?

Markdown 在线编辑,支持预览:
(1)cmd Markdown
(2)http://mahua.jser.me/ (表格显示有问题)

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

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

段落例子
说明:如你所见,编辑时候,可以一行成段也可以多行成段,但都是以空行划分段落。
2、Markdown 标题:
(1)类 Setext 形式
采用底线 “=” 最高阶标题 ,“-”第二阶标题,“=”和“-”没有数量限制,>=2 即可。

Setex实例
(2)类 Atx 形式
1-6 个 “#” ,对应 1 到 6 阶
Atx实例

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:

title属性
效果显示输出:
链接实例

说明:这里的 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>

效果输出:
HTML代码实例
七、图片
图片的 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:
Html实例
效果输出:
样例输出
标记整段的代码域:每行代码进行缩进或者一个 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 输出
效果显示:
行内代码
以上是自己常用的语法。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值