一、关于标题

规范的README文件开头都写上一个标题，这被称为大标题。

[plain] view plaincopy

1. 大标题  
2. ====  

比大标题低一级的是中标题，也就是显示出来比大标题小点。

[plain] view plaincopy

1. 中标题  
2. -------  

在文本下面加上 下划线 - ，那么上方的文本就变成了中标题，同样的 下划线个数无限制。

除此之外，你也会发现大，中标题下面都有一条横线，没错这就是 = 和 - 的显示结果。

如果你只输入了等于号=，但其上方无文字，那么就只会显示一条直线。如果上方有了文字，但你又只想显示一条横线，而不想把上方的文字转义成大标题的话，那么你就要在等于号=和文字直接补一个空行。

补空行：是很常用的用法，当你不想上下两个不同的布局方式交错到一起的时候，就要在两种布局之间补一个空行。

如果你只输入了短横线（减号）-，其上方无文字，那么要显示直线，必须要写三个减号以上。不过与等于号的显示效果不同，它显示出来时虚线而不是实线。同减号作用相同的还有星号*和下划线_，同样的这两者符号也要写三个以上才能显示一条虚横线。

除此以外，关于标题还有等级表示法，分为六个等级，显示的文本大小依次减小。不同等级之间是以井号  #  的个数来标识的。一级标题有一个 #，二级标题有两个# ，以此类推。

[plain] view plaincopy

1. #一级标题  
2. ##二级标题  
3. ###三级标题  
4. ####四级标题  
5. #####五级标题  
6. ######六级标题  

实际上，前文所述的大标题和中标题是分别和一级标题和二级标题对应的。即大标题大小和一级标题相同，中标题大小和二级标题相同。

二、显示文本

1. 普通文本

直接输入的文字就是普通文本。需要注意的是要换行的时候不能直接通过回车来换行，需要使用
(或者
)。也就是html里面的标签。事实上，markdown支持一些html标签，你可以试试。当然如果你完全使用html来写的话，就丧失意义了，毕竟markdown并非专门做前端的，然而仅实现一般效果的话，它会比html写起来要简洁得多得多啦。

[plain] view plaincopy

1. 这是一段普通的文本，  
2. 直接回车不能换行，
     
3. 要使用\
     

效果如图：

此外，要显示一个超链接的话，就直接输入这个链接的URL就好了。显示出来会自动变成可链接的形式的。

显示空格的小Tip

2. 单行文本

使用两个Tab符实现单行文本。

[plain] view plaincopy

1. Hello,大家好，我是果冻虾仁。  

3. 多行文本

多行文本和单行文本异曲同工，只要在每行行首加两个Tab

[plain] view plaincopy

1. 欢迎到访  
2. 很高兴见到您  
3. 祝您，早上好，中午好，下午好，晚安  

4. 部分文字的高亮

如果你想使一段话中部分文字高亮显示，来起到突出强调的作用，那么可以把它用 `  ` 包围起来。注意这不是单引号，而是Tab上方，数字1左边的按键（注意使用英文输入法）。

Thank `You` . Please `Call` Me `Coder`

5. 文字超链接

给一段文字加入超链接的格式是这样的 [ 要显示的文字 ]( 链接的地址 )。比如：

[plain] view plaincopy

1. [我的博客](http://blog.itpub.net/30316686/)  

你还可以给他加上一个鼠标悬停显示的文本。

[plain] view plaincopy

1. [我的博客](http://blog.itpub.net/30316686/ "悬停显示")  

三、插入符号

1. 圆点符

• 这是一个圆点符
• 这也是一个圆点符

上面这段的圆点是CSDN博客编辑器里面的符号列表。写文章在列出条目时经常用到。在GitHub的markdown语法里也支持使用圆点符。编辑的时候使用的是星号 *

[plain] view plaincopy

1. * 昵称：果冻虾仁  
2. * 别名：隔壁老王  
3. * 英文名：Jelly  

此外还有二级圆点和三级圆点。就是多加一个Tab。

[plain] view plaincopy

1. * 编程语言  
2.     * 脚本语言  
3.         * Python  

如果你觉得三级的结构还不够表达清楚的话，我们可以试着换一种形式，请看字符包围

2. 缩进

缩进的含义是很容易理解的。。

[plain] view plaincopy

1. >数据结构  
2. >>树  
3. >>>二叉树  
4. >>>>平衡二叉树  
5. >>>>>满二叉树  

当然比这个更一般的用法是这样。常常能在书籍里面看到的效果，比如引用别人的文章。直接看效果。

具体这个“缩进”的用法。大家自己摸索吧。

3. 插入图片

来源于网络的图片

网上有很多README插入图片的教程了，经我自己多次测试呢，发现可以使用的最简单，最基本的语法是：

[plain] view plaincopy

1.   

即 叹号! + 方括号[ ] + 括号( ) 其中叹号里是图片的URL。

如果不加叹号! ,就会变成普通文本baidu了。

在方括号里可以加入一些 标识性的信息，比如

[plain] view plaincopy

1.   

这个方括号里的baidu并不会对图像显示造成任何改动，如果你想达到鼠标悬停显示提示信息，那么可以仿照前面介绍的文本中的方法，就是这样：

[plain] view plaincopy

1.   

GitHub仓库里的图片

有时候我们想显示一个GitHub仓库(或者说项目)里的图片而不是一张其他来源网络图片，因为其他来源的URL很可能会失效。那么如何显示一个GitHub项目里的图片呢？

其实与上面的格式基本一致的，所不同的就是括号里的URL该怎么写。

    https://github.com/ 你的用户名 / 你的项目名 / raw / 分支名 / 存放图片的文件夹 / 该文件夹下的图片

这样一目了然了吧。比如：

[plain] view plaincopy

1.   

给图片加上超链接

如果你想使图片带有超链接的功能，即点击一个图片进入一个指定的网页。那么可以这样写：

[plain] view plaincopy

1. [![baidu]](http://baidu.com)  
2. [baidu]:http://www.baidu.com/img/bdlogo.gif "百度Logo"  

这样就能实现 点击图片进入网页的功能了。

4. 插入代码片段

我们需要在代码的上一行和下一行用` `` 标记。``` 不是三个单引号，而是数字1左边，Tab键上面的键。要实现语法高亮那么只要在 ``` 之后加上你的编程语言即可（忽略大小写）。c++语言可以写成c++也可以是cpp。看代码：

实际显示效果