0%

makedown-syntax


layout: post
title: Makedown语法简介
description:
category: 编辑
tags: makedown



段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

简单说:连续两个回车完成对段落的换行。

在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加四个以上的“=”和“-”,他们分别表示一级标题和二级标题。例如:

H1
=======
H2
-------

H1

H2

第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)例如:

# H1
## H2
##### H5

H1

H2

H5

引用

通过在文字开头添加“>”表示块注释。区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >

> This is the first level of quoting.
>   
> > This is nested blockquote.
>   
> Back to the first level.

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

> ## 这是一个标题。
>   
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

*   Red
*   Green
*   Blue
  • Red
  • Green
  • Blue

等同于:

+   Red
+   Green
+   Blue
  • Red
  • Green
  • Blue

也等同于:

-   Red
-   Green
-   Blue
  • Red
  • Green
  • Blue

有序列表则使用数字接着一个英文句点:

1.  Bird
2.  McHale
3.  Parish
  1. Bird
  2. McHale
  3. Parish

代码

实现方式有两种:

第一种:简单文字出现一个代码框。使用`(不是单引号而是左上角的ESC下面~中的

`<blockquote>`

<blockquote>

第二种:大片文字需要实现代码框。使用Tab和四个空格。

int main()
{
//
}

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。

***
---


Markdown中有两种方式实现链接,分别为内联方式和引用方式,不管是哪一种,链接文字都是用 [方括号] 来标记。

内联方式:

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

This is an example link.

引用方式:

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"

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”

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 *_ 包围的字词会被转成用 <em> 标签包围,用两个 *_ 包起来的话,则会被转成 <strong>,例如:

1个为斜体,两个为粗体。

*single asterisks*
_single underscores_
**double asterisks**
__double underscores__

single asterisks
single underscores
double asterisks
double underscores

你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束。

强调也可以直接插在文字中间:

un*frigging*believable

unfriggingbelievable

但是如果你的 *_ 两边都有空白的话,它们就只会被当成普通的符号

如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:

\*this text is surrounded by literal asterisks\*

*this text is surrounded by literal asterisks*

图片

图片的处理方式和链接的处理方式,非常的类似。

内联方式:

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

引用方式:

![alt text][id] 
...
[id]: /path/to/img.jpg "Title"

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠:

\*literal asterisks\*

*literal asterisks*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

References: