Markdown语法学习笔记

Maekdown语法都是由一些符号所组成,并且这些符号简单易懂,一看就能了解它的含义。现在好多博客和网站的输入框都可以支持Markdown语法进行文本编辑了。最后使用Markdown的一个最大的好处就是文本可以离线编辑,还可以确保文本的格式,不一定要在线的输入框里进行编辑。

Markdown 语法说明_缩减版/(完全版传送门)

区块元素

段落和换行

1) 在段落中可以通过手动输入 <br/> 来实现文本中的强制换行。
2) 如果一定要Markdown来自动生成 <br/> 来实现换行的话,就在插入的地方按两个以上空格然后回车。


标题


Markdown支持两种方式来实现标题:
1) 利用 “=“ 来表示一级标题,用 “-“ 来表示二级标题,其中符号可以是任意多个的。

一级标题
======
二级标题
-------  

效果如下:

一级标题

二级标题

2) 利用 “#“ 来表示一级标题,用 “##“ 来表示二级标题。等级可以由1-6,分别为 # 的个数

# 一级标题 h1
## 二级标题 h2
###### 六级标题 h6  

效果如下:

一级标题 h1

二级标题 h2

六级标题 h6


区块引用


只需要在要引用的段落前添加 > 符号,还允许偷懒只在段落第一行使用 > 符号。

>This is a blockquote with two paragraphs. Lorem ipsum dolor sit
amet,consectetuer adipiscing elit. Aliquam hendrerit mi posuere 
lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus.

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

并且 > 可以嵌套使用,且在其中还可以使用别的Markdown语法。

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

效果如下:

这是一个标题。

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

给出一些例子代码:

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


列表


Markdown支持无序列表和有序列表。这个不止可以用来编列列表,还可以让长段的文字也按列表形式排列,可自行尝试。
其中可以使用 *, +, - 号来实现列表。并且通过缩进可以书写二级列表。如下:

*  red
*  green
*  blue

+  red
    +  dark red
    +  light red
+  green
+  blue

-  red
-  green
-  blue  

效果如下:

  • red
    • dark red
    • light red
  • green
  • blue

通过书写数字和.可以生成有序列表,其中数字不是有序的也无所谓。

1. red
49. green
30. blue

效果如下:

  1. red
  2. green
  3. blue


代码块


如果想要插入一段代码(即形成一个代码块),并且保持代码的一定样式,只需要简单缩进4个空格或者1个制表符就可以了。

#include <iostream>
using namespace std;

int main(){
    printf("hello world.");
}  

当我们使用了一些高亮代码块的插件之后。我们则还可以通过三个`符号来包含代码块,例如:

1
2
3
4
5
6
#include <iostream>
using namespace std;
int main(){
printf("hello world.");
}


分隔线


在一行中使用连续三个及以上的 *, -, _ 号,且这行中不包含别的符号,就可以生成一条分割线。符号之间还可以包括空格。

* * *
***
***
- - -
______________________

效果如下:







持续更行中…(最新更新时间:2015/8/23)