你当前进入的页面是教你如何书写Markdown语法的教程。
GitHub上的markdown语法在标准的markdown语法基础上做了扩充,称之为GitHub Flavored Markdown
。简称GFM
,GFM在GitHub上有广泛应用,除了README文件外,issues和wiki均支持markdown语法。
也叫水平分割线,使用***
、---
、___
可以显示横线效果(注意:可以任意多个字符,但是不少于三个,如********
, -------------
)
***
---
___
*******
效果如下:
使用 #
符号表示,尽可能在符号后面加上一个空格,然后才输入标题文本
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果如下:
分:普通文本、单行文本、文本块
直接在新的一行输入你想要输入的文本段落
效果如下:
这是一段普通的文本
在一行开头加入1个Tab或者4个空格。
效果如下:
Hello,大家好,我来自中国。
在连续几行的文本开头加入1个Tab或者4个空格。
例如:
欢迎到访
很高兴见到您
祝您,早上好,中午好,下午好,晚安
上面三句话前面都有四个空格或1个Tab
效果如下:
欢迎到访
很高兴见到您
祝您,早上好,中午好,下午好,晚安
使用一对各三个的反引号(反引号就是键盘上Tab键上面那颗键)
```
欢迎到访
我是C++码农
你可以在知乎、CSDN、简书搜索找到我
```
效果如下:
欢迎到访
我是C#码农
你可以在知乎、CSDN、博客园搜索找到我
该语法也可以实现代码高亮,见代码高亮
文字高亮功能能使行内部分文字高亮,使用一对反引号。
语法
`linux` `网络编程` `socket` `epoll`
效果如下:
linux
网络编程
socket
epoll
也适合做一篇文章的tag
直接回车不能换行
可以在上一行文本或者段落后面补两个空格
这样下一行的文本就换行了。
或者就是在两行文本直接加一个空行。
也能实现换行效果,不过这个行间距有点大。
语法 | 效果 |
---|---|
*斜体1* |
斜体1 |
_斜体2_ |
斜体2 |
**粗体1** |
粗体1 |
__粗体2__ |
粗体2 |
这是一个 ~~删除线~~ |
这是一个 |
***斜粗体1*** |
斜粗体1 |
___斜粗体2___ |
斜粗体2 |
***~~斜粗体删除线1~~*** |
|
~~***斜粗体删除线2***~~ |
注意 : 斜体、粗体、删除线可混合使用
基本格式:
![alt](URL title)
alt和title即对应HTML中的alt和title属性(都可省略):
- alt表示图片显示失败时的替换文本
- title表示鼠标悬停在图片时的显示文本(注意这里要加引号)
URL即图片的url地址,如果引用本仓库中的图片,直接使用相对路径就可了,如果引用其他github仓库中的图片要注意格式,即:仓库地址/raw/分支名/图片路径
,如:
https://raw.githubusercontent.com/ijrou/guide/master/img/20161201111356.jpg
# | 语法 | 效果 |
---|---|---|
1 | ![baidu](http://www.baidu.com/img/bdlogo.gif "百度logo") |
|
2 | ![](./img/20161201110120.gif) |
|
3 | ![][dog] |
注意例3的写法使用了URL标识符的形式,在链接一节有介绍。
在文末有dog的定义:
[dog]:https://raw.githubusercontent.com/ijrou/guide/master/img/20161201111356.jpg
# | 语法 | 效果 |
---|---|---|
1 | [我的博客](http://www.cnblogs.com/abc1069/ "悬停显示") |
我的博客 |
2 | [我的CSDN][csdn] |
我的CSDN |
语法2由两部分组成:
- 第一部分使用两个中括号,[ ]里的标识符(本例中cnblogs),可以是数字,字母等的组合,标识符上下对应就行了(姑且称之为URL标识符)
- 第二部分标记实际URL。
使用URL标识符能达到复用的目的,一般把全文所有的URL标识符统一放在文章末尾,这样看起来比较干净。除了干净之外,它还能达到复用的目的,比如你在多个地方想使用同一个链接,那么文内使用标识符,只在最底部给标识符定义出实际的URL链接即可,类似编程语言中的变量。
URL标识符是我起的名字,不知道是否准确。囧。。
语法 | 效果 |
---|---|
[我的简介](/example/profile.md) |
我的简介 |
[book](./Book) |
book |
给图片加链接的本质是混合图片显示语法和普通的链接语法。普通的链接中[ ]内部是链接要显示的文本,而图片链接[ ]里面则是要显示的图片。
直接混合两种语法当然可以,但是十分啰嗦,为此我们可以使用URL标识符的形式。
# | 语法 | 效果 |
---|---|---|
1 | [![weibo-logo]](http://weibo.com/3310352530/profile?is_all=1) |
|
2 | [![](./img/cnblogs_logo.png "我的知乎")][cnblogs] |
|
3 | [![csdn-logo]][csdn] |
因为图片本身和链接本身都支持URL标识符的形式,所以图片链接也可以很简洁(见例3)。
注意,此时鼠标悬停时显示的文字是图片的title,而非链接本身的title了。
本文URL标识符都放置于文末
其实呢,每一个标题都是一个锚点,和HTML的锚点(
#
)类似,比如我们
语法 | 效果 |
---|---|
[回到顶部](#markdown学习手册github) |
回到顶部 |
不过要注意,标题中的英文字母都被转化为小写字母了。
以前GitHub对中文支持的不好,所以中文标题不能正确识别为锚点,但是现在已经没问题啦!
语法
* 昵称:果冻虾仁
- 别名:隔壁老王
* 英文名:Jelly
效果如下:
- 昵称:果冻虾仁
- 别名:隔壁老王
- 英文名:Jelly
语法
* 编程语言
* 脚本语言
* Python
效果如下:
- 编程语言
- 脚本语言
- Python
- 脚本语言
就是在数字后面加一个点,再加一个空格。不过看起来起来可能不够明显。
语法
1. 封装
2. 继承
3. 多态
效果如下:
- 封装
- 继承
- 多态
和无序列表一样,有序列表也有多级结构:
语法
1. 这是一级的有序列表,数字1还是1
1. 这是二级的有序列表,阿拉伯数字在显示的时候变成了罗马数字
1. 这是三级的有序列表,数字在显示的时候变成了英文字母
2. 四级的有序列表显示效果,就不再变化了,依旧是英文字母
效果如下:
- 这是一级的有序列表,数字1还是1
- 这是二级的有序列表,阿拉伯数字在显示的时候变成了罗马数字
- 这是三级的有序列表,数字在显示的时候变成了英文字母
- 四级的有序列表显示效果,就不再变化了,依旧是英文字母
- 这是二级的有序列表,阿拉伯数字在显示的时候变成了罗马数字
语法
- [x] 需求分析
- [x] 系统设计
- [x] 详细设计
- [ ] 编码
- [ ] 测试
- [ ] 交付
效果如下:
- 需求分析
- 系统设计
- 详细设计
- 编码
- 测试
- 交付
您可以使用这个功能来标注某个项目各项任务的完成情况。
在GitHub的issue中使用该语法是可以实时点击复选框来勾选或解除勾选的,而无需修改issue原文。
文本摘自《深入理解计算机系统》P27
令人吃惊的是,在哪种字节顺序是合适的这个问题上,人们表现得非常情绪化。实际上术语“little endian”(小端)和“big endian”(大端)出自Jonathan Swift的《格利佛游记》一书,其中交战的两个派别无法就应该从哪一端打开一个半熟的鸡蛋达成一致。因此,争论沦为关于社会政治的争论。只要选择了一种规则并且始终如一的坚持,其实对于哪种字节排序的选择都是任意的。
“端”(endian)的起源
以下是Jonathan Swift在1726年关于大小端之争历史的描述:
“……下面我要告诉你的是,Lilliput和Blefuscu这两大强国在过去36个月里一直在苦战。战争开始是由于以下的原因:我们大家都认为,吃鸡蛋前,原始的方法是打破鸡蛋较大的一端,可是当今的皇帝的祖父小时候吃鸡蛋,一次按古法打鸡蛋时碰巧将一个手指弄破了,因此他的父亲,当时的皇帝,就下了一道敕令,命令全体臣民吃鸡蛋时打破较小的一端,违令者重罚。”
语法
>数据结构
>>树
>>>二叉树
>>>>平衡二叉树
>>>>>满二叉树
效果如下:
数据结构
树
二叉树
平衡二叉树
满二叉树
语法
在三个反引号后面加上编程语言的名字,另起一行开始写代码,最后一行再加上三个反引号。
```javascript
document.getElementById("myH1").innerHTML="Welcome to my Homepage"; //javascipt
```
效果如下:
document.getElementById("myH1").innerHTML="Welcome to my Homepage"; //javascipt
public static void main(String[]args){} //Java
int main(int argc, char *argv[]) //C
echo "hello GitHub" #Bash
string &operator+(const string& A,const string& B) //cpp
表头1 | 表头2
--------- | --------
表格单元 | 表格单元
表格单元 | 表格单元
效果如下:
表头1 | 表头2 |
---|---|
表格单元 | 表格单元 |
表格单元 | 表格单元 |
| 表头1 | 表头2|
| ---------- | -----------|
| 表格单元 | 表格单元 |
| 表格单元 | 表格单元 |
效果如下:
表头1 | 表头2 |
---|---|
表格单元 | 表格单元 |
表格单元 | 表格单元 |
表格可以指定单元格对齐方式
| 左对齐 | 居中 | 右对齐 |
| :------------ | :-------------: | ----: |
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
效果如下:
左对齐 | 居中 | 右对齐 |
---|---|---|
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 |
效果如下:
名字 | 描述 |
---|---|
Help | |
Close | Closes a window |
表格中嵌入图片(链接)
其实前面介绍图片显示、图片链接的时候为了清晰就是放在在表格中显示的。
| 图片 | 描述 |
| :------------------: | :--: |
| ![baidu][baidu-logo] | 百度 |
效果如下:
图片 | 描述 |
---|---|
百度 |
Github的Markdown语法支持添加emoji表情,输入不同的符号码(两个冒号包围的字符)可以显示出不同的表情。
比如:blush:
,可以显示:blush:。
具体每一个表情的符号码,可以查询GitHub的官方网页http://www.emoji-cheat-sheet.com。
但是这个网页每次都打开奇慢......所以整理到了本系列中,大家可以直接在此查看emoji。
版本控制的系统中都少不了diff的功能,即展示一个文件内容的增加与删除。 GFM中可以显示的展示diff效果。使用绿色表示新增,红色表示删除。
语法
其语法与代码高亮类似,只是在三个反引号后面写diff,
并且其内容中,可以用 +
开头表示新增,-
开头表示删除。
另外还有有 !
和#
的语法,写法如下:
```diff
+ 人闲桂花落,
- 夜静春山空。
! 月出惊山鸟,
# 时鸣春涧中。
```
效果如下:
+ 人闲桂花落,
- 夜静春山空。
! 月出惊山鸟,
# 时鸣春涧中。
说明:本系列转载于:果冻虾仁 并重新排版修改,如原著敏感本系列,你TM来打我啊~