wangn

look up

博客园 首页 联系 订阅 管理

Markdown 官方文档

这里可以看到官方的 Markdown 语法规则文档

上文代码[区块嵌套]

>这里可以看到官方的 Markdown 语法规则文档
> * [创始人 John Gruber 的 Markdown 语法说明](https://daringfireball.net/projects/markdown/syntax)
> * [Markdown 中文版语法说明](http://wowubuntu.com/markdown/#list)
> * [Markdown——入门指南](http://www.jianshu.com/p/1e402922ee32/) 这篇可以着重细读!

目录

1、字体

*斜体*
_斜体_
**粗体**
***加粗斜体***
~~删除线~~

显示效果:

斜体
斜体
粗体
加粗斜体
删除线

2、标题

  • 方法1:类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),任何数量的 = 和 - 都可以有效果。例如:
This is an H1
=============

This is an H2
-------------

显示效果:

This is an H1

This is an H2

  • 方法2:类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:
# 这是 H1
## 这是 H2
### 这是H3
#### 这是H4
##### 这是H5
###### 这是 H6

显示效果:

这是 H1

这是 H2

这是H3

这是H4

这是H5
这是 H6

3、区块引用

区块引用每行加上 >

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. 

显示效果:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet

Donec sit amet nisl. Aliquam semper ipsum sit amet velit.

也可以只在整个段落的第一行最前面加上 >

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

显示效果:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

区块嵌套可以使用多个 >

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

显示效果:

This is the first level of quoting.

This is nested blockquote.

区块嵌套其它语法:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码:
> 
>     return shell_exec("echo $input | $markdown_script");

显示效果:

这是一个标题。

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

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

4、列表

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

*   Red
*   Green
*   Blue
+   Red
+   Green
+   Blue
-   Red
-   Green
-   Blue

显示效果:

  • Red
  • Green
  • Blue

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

1.  Bird
2.  McHale
3.  Parish

显示效果:

  1. Bird
  2. McHale
  3. Parish

5、代码高亮

  • 方法1:使用 ``` 符号

注意三个“`”是在英文状态下“~”键,ESC下面

```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
```

显示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
  • 方法2:缩进 4 个空格或是 1 个制表符
    #include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

显示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

6、分割线

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

* * *

***

*****

- - -

---------------------------------------

7、链接

Markdown 的链接分为行内式参考式两种,行内式使用较多,参考式略显复杂。

  • 行内式,[]里写链接文字,()里写链接地址, ()中的“”中为链接指定title属性,可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。
欢迎来到[baidu](http://www.baidu.com/)
欢迎来到[baidu](http://www.baidu.com/ "baidu")

显示效果:

欢迎来到baidu
欢迎来到baidu

  • 参考式,一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。

未完待续!

posted on 2017-09-13 18:41  wangn  阅读(271)  评论(0编辑  收藏  举报