README

该文件用来测试和展示书写README的各种markdown语法。GitHub的markdown语法在标准的markdown语法基础上做了扩充，称之为GitHub Flavored Markdown。简称GFM，GFM在GitHub上有广泛应用，除了README文件外，issues和wiki均支持markdown语法。

Author	believeszw
E-mail	765846560@qq.com
Github	https://github.com/believeszw

横线
标题
文本
- 普通文本
- 单行文本
- 多行文本
- 文字高亮
- 换行
- 斜体
- 粗体
- 删除线
图片
- 来源于网络的图片
- GitHub仓库中的图片
链接
- 文字超链接
  - 链接外部URL
  - 链接本仓库里的URL
- 锚点
- 图片链接
列表
- 无序列表
- 有序列表
- 复选框列表
块引用
代码高亮
表格
表情
diff语法

横线

***、—、___可以显示横线效果

标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

文本

普通文本

这是一段普通的文本

单行文本

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

在一行开头加入1个Tab或者4个空格。

文本块

语法1

在连续几行的文本开头加入1个Tab或者4个空格。

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

语法2

使用一对各三个的反引号：

欢迎到访
我是C++码农
你可以在知乎、CSDN、简书搜索【果冻虾仁】找到我

该语法也可以实现代码高亮，见代码高亮

文字高亮

文字高亮功能能使行内部分文字高亮，使用一对反引号。
语法：

`linux` `网络编程` `socket` `epoll`

效果：linux 网络编程 socket epoll

也适合做一篇文章的tag

换行

直接回车不能换行，
可以在上一行文本后面补两个空格，
这样下一行的文本就换行了。

或者就是在两行文本直接加一个空行。

也能实现换行效果，不过这个行间距有点大。

斜体、粗体、删除线

语法	效果
`斜体1`	斜体1
`_斜体2_`	斜体2
`粗体1`	粗体1
`__粗体2__`	粗体2
`这是一个 ~~删除线~~`	这是一个删除线
`*斜粗体1*`	斜粗体1
`___斜粗体2___`	斜粗体2
`*~~斜粗体删除线1~~*`	斜粗体删除线1
`~~*斜粗体删除线2*~~`	斜粗体删除线2

斜体、粗体、删除线可混合使用

图片

基本格式：

![alt](URL title)

alt和title即对应HTML中的alt和title属性（都可省略）：

alt表示图片显示失败时的替换文本
title表示鼠标悬停在图片时的显示文本（注意这里要加引号）

URL即图片的url地址，如果引用本仓库中的图片，直接使用相对路径就可了，如果引用其他github仓库中的图片要注意格式，即：仓库地址/raw/分支名/图片路径，如：

https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif

#	语法	效果
1	`[外链图片转存失败(img-vEtchDOQ-1566288187751)(http://www.baidu.com/img/bdlogo.gif "百度logo")]`	[外链图片转存失败(img-JIUVHmnk-1566288187753)(http://www.baidu.com/img/bdlogo.gif “百度logo”)]
2	`![][code-past]`

注意例2的写法使用了URL标识符的形式，在链接一节有介绍。

在文末有code-past的定义：

[code-past]:https://img-blog.csdnimg.cn/201908060004034.png

链接

链接外部URL

#	语法	效果
1	`[我的博客](https://blog.csdn.net/believe_s "悬停显示")`	我的博客

语法2由两部分组成：

第一部分使用两个中括号，[ ]里的标识符（本例中zhihu），可以是数字，字母等的组合，标识符上下对应就行了（姑且称之为URL标识符）
第二部分标记实际URL。

使用URL标识符能达到复用的目的，一般把全文所有的URL标识符统一放在文章末尾，这样看起来比较干净。

URL标识符是我起的名字，不知道是否准确。囧。。

链接本仓库里的URL

语法	效果
`[README](./README.md)`	README

图片链接

给图片加链接的本质是混合图片显示语法和普通的链接语法。普通的链接中[ ]内部是链接要显示的文本，而图片链接[ ]里面则是要显示的图片。
直接混合两种语法当然可以，但是十分啰嗦，为此我们可以使用URL标识符的形式。

#	语法	效果
1	`[[外链图片转存失败(img-3jm1Qz26-1566288187754)(https://www.weibo.com/believeszw)]`	[[外链图片转存失败(img-pcOhbHDa-1566288187755)(https://www.weibo.com/believeszw)]
2	`[[外链图片转存失败(img-7xvl2fyP-1566288187755)(/img/zhihu.png "我的知乎，欢迎关注")]][zhihu]`	[外链图片转存失败(img-Ne6Tj9wI-1566288187756)(/img/zhihu.png “我的知乎，欢迎关注”)]
3	`[![csdn-logo]][csdn]`

因为图片本身和链接本身都支持URL标识符的形式，所以图片链接也可以很简洁（见例3）。
注意，此时鼠标悬停时显示的文字是图片的title，而非链接本身的title了。

本文URL标识符都放置于文末

锚点

其实呢，每一个标题都是一个锚点，和HTML的锚点（#）类似，比如我们

语法	效果
`[回到顶部](#readme)`	回到顶部

不过要注意，标题中的英文字母都被转化为小写字母了。

以前GitHub对中文支持的不好，所以中文标题不能正确识别为锚点，但是现在已经没问题啦！

列表

无序列表

语法

* 昵称：believe_s
* 英文名：believe

效果

昵称：believe_s
英文名：believe

多级无序列表

语法

* 编程语言* 脚本语言* Python

效果

编程语言
- 脚本语言
  - Python

一级有序列表

语法

就是在数字后面加一个点，再加一个空格。不过看起来起来可能不够明显。

面向对象的三个基本特征：1. 封装
2. 继承
3. 多态

效果

面向对象的三个基本特征：

封装
继承
多态

多级有序列表

和无序列表一样，有序列表也有多级结构。

语法

1. 这是一级的有序列表，数字1还是11. 这是二级的有序列表，阿拉伯数字在显示的时候变成了罗马数字1. 这是三级的有序列表，数字在显示的时候变成了英文字母

效果

这是一级的有序列表，数字1还是1
1. 这是二级的有序列表，阿拉伯数字在显示的时候变成了罗马数字
  1. 这是三级的有序列表，数字在显示的时候变成了英文字母

复选框列表

语法

- [x] 需求分析
- [x] 系统设计
- [x] 详细设计
- [ ] 编码
- [ ] 测试
- [ ] 交付

效果

需求分析
系统设计
详细设计
编码
测试
交付

您可以使用这个功能来标注某个项目各项任务的完成情况。

Tip:

在GitHub的issue中使用该语法是可以实时点击复选框来勾选或解除勾选的，而无需修改issue原文。

块引用

常用于引用文本

文本摘自《深入理解计算机系统》P27

令人吃惊的是，在哪种字节顺序是合适的这个问题上，人们表现得非常情绪化。实际上术语“little endian”（小端）和“big endian”（大端）出自Jonathan Swift的《格利佛游记》一书，其中交战的两个派别无法就应该从哪一端打开一个半熟的鸡蛋达成一致。因此，争论沦为关于社会政治的争论。只要选择了一种规则并且始终如一的坚持，其实对于哪种字节排序的选择都是任意的。

“端”（endian）的起源
以下是Jonathan Swift在1726年关于大小端之争历史的描述：
“……下面我要告诉你的是，Lilliput和Blefuscu这两大强国在过去36个月里一直在苦战。战争开始是由于以下的原因：我们大家都认为，吃鸡蛋前，原始的方法是打破鸡蛋较大的一端，可是当今的皇帝的祖父小时候吃鸡蛋，一次按古法打鸡蛋时碰巧将一个手指弄破了，因此他的父亲，当时的皇帝，就下了一道敕令，命令全体臣民吃鸡蛋时打破较小的一端，违令者重罚。”

块引用有多级结构

语法

> 数据结构
>> 树
>>> 二叉树
>>>> 平衡二叉树
>>>>> 满二叉树

效果

数据结构

树

二叉树

平衡二叉树

满二叉树

代码高亮

语法

在三个反引号后面加上编程语言的名字，另起一行开始写代码，最后一行再加上三个反引号。

效果

public static void main(String[]args){} //Java

int main(int argc, char *argv[]) //C

echo "hello GitHub" #Bash

document.getElementById("myH1").innerHTML="Welcome to my Homepage"; //javascipt

string &operator+(const string& A,const string& B) //cpp

表格

表头1	表头2
表格单元	表格单元
表格单元	表格单元

表头1	表头2
表格单元	表格单元
表格单元	表格单元

对齐

表格可以指定对齐方式

左对齐	居中	右对齐
col 3 is	some wordy text	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

混合其他语法

表格单元中的内容可以和其他大多数GFM语法配合使用，如：

使用普通文本的删除线，斜体等效果

名字	描述
Help	Display the help window.
Close	Closes a window

表格中嵌入图片（链接）

其实前面介绍图片显示、图片链接的时候为了清晰就是放在在表格中显示的。

图片	描述
	百度

表情

Github的Markdown语法支持添加emoji表情，输入不同的符号码（两个冒号包围的字符）可以显示出不同的表情。

比如:blush:，可以显示?。

具体每一个表情的符号码，可以查询GitHub的官方网页http://www.emoji-cheat-sheet.com。

但是这个网页每次都打开奇慢。。所以我整理到了本repo中，大家可以直接在此查看emoji。

diff语法

版本控制的系统中都少不了diff的功能，即展示一个文件内容的增加与删除。
GFM中可以显示的展示diff效果。使用绿色表示新增，红色表示删除。

语法

其语法与代码高亮类似，只是在三个反引号后面写diff，
并且其内容中，可以用 +开头表示新增，-开头表示删除。
另外还有有 !和#的语法。

效果

+ 人闲桂花落，
- 夜静春山空。
! 月出惊山鸟，
# 时鸣春涧中。

书写README的各种markdown语法相关推荐

【Python生成readme文件】——Markdown语法
链接:https://www.cnblogs.com/wj-1314/p/8547763.html
书写博客: Markdown 语法讲解
Typora软件学习 Markdown 语法讲解一级目录二级目录三级目录三级目录字体引用分割线图片超链接列表表格代码 Markdown 语法讲解一级标题一个#符号加空格回车 ...
.md文件以及markdown语法书写md文档
.md文件以及markdown语法书写md文档 1. .md文件如何打开 2. markdown是什么? 2.1 markdown用来干嘛? 2.2 怎样书写和读取markdown? 3. markd ...
Markdown语法简介
Markdown是一种方便记忆.书写的纯文本标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档.它目标是实现易读易写.Markdown的语法全由一些符号所组成.Markdown语法 ...
5分钟学会Markdown语法，在GitHub上写出漂亮文本，提升别人阅读体验
今天研究下在GitHub中如何漂亮的书写readme部分 markdown是一种纯文本格式的标记语言.通过简单的标记语法,它可以使普通文本内容具有一定的格式. 1.因为是纯文本,所以只要支持markd ...
Markdown语法-基础
2019独角兽企业重金招聘Python工程师标准>>> 1. 标题 Markdown支持两种标题标记语法,我个人常用的是 # 井号标记,使用很简单,在文字前添加 1-6个# ,分别代 ...
Markdown 语法介绍
Markdown 语法介绍 from:https://coding.net/help/doc/project/markdown.html 文章内容 1 Markdown 语法介绍 1.1 标题 1.2 ...
Markdown 语法说明
Markdown 语法说明 (简体中文版) / (点击查看快速入门) 概述宗旨 Markdown 的目标是实现「易读易写」. 可读性,无论如何,都是最重要的.一份使用 Markdown 格式撰写的文 ...
Markdown 语法说明 (简体中文版)
NOTE: This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for Engli ...

书写README的各种markdown语法