README.md 编写
1 Spring Boot Demo 2 =========================== 3 该文件用来测试和展示书写README的各种markdown语法。GitHub的markdown语法在标准的markdown语法基础上做了扩充,称之为`GitHub Flavored Markdown`。简称`GFM`,GFM在GitHub上有广泛应用,除了README文件外,issues和wiki均支持markdown语法。 4 5 **** 6 7 |Author|果冻虾仁| 8 |---|--- 9 |E-mail|Jelly.K.Wang@qq.com 10 11 12 **** 13 ## 目录 14 * [横线](#横线) 15 * [标题](#标题) 16 * [文本](#文本) 17 * 普通文本 18 * 单行文本 19 * 多行文本 20 * 文字高亮 21 * 换行 22 * 斜体 23 * 粗体 24 * 删除线 25 * [图片](#图片) 26 * 来源于网络的图片 27 * GitHub仓库中的图片 28 * [链接](#链接) 29 * 文字超链接 30 * 链接外部URL 31 * 链接本仓库里的URL 32 * 锚点 33 * [图片链接](#图片链接) 34 * [列表](#列表) 35 * 无序列表 36 * 有序列表 37 * 复选框列表 38 * [块引用](#块引用) 39 * [代码高亮](#代码高亮) 40 * [表格](#表格) 41 * [表情](#表情) 42 * [diff语法](#diff语法) 43 44 ### 横线 45 ----------- 46 ***、---、___可以显示横线效果 47 48 *** 49 --- 50 ___ 51 52 53 54 标题 55 ------ 56 57 # 一级标题 58 ## 二级标题 59 ### 三级标题 60 #### 四级标题 61 ##### 五级标题 62 ###### 六级标题 63 64 65 文本 66 ------ 67 ### 普通文本 68 这是一段普通的文本 69 ### 单行文本 70 Hello,大家好,我是果冻虾仁。 71 在一行开头加入1个Tab或者4个空格。 72 ### 文本块 73 #### 语法1 74 在连续几行的文本开头加入1个Tab或者4个空格。 75 76 欢迎到访 77 很高兴见到您 78 祝您,早上好,中午好,下午好,晚安 79 80 #### 语法2 81 使用一对各三个的反引号: 82 ``` 83 欢迎到访 84 我是C++码农 85 你可以在知乎、CSDN、简书搜索【果冻虾仁】找到我 86 ``` 87 该语法也可以实现代码高亮,见[代码高亮](#代码高亮) 88 ### 文字高亮 89 文字高亮功能能使行内部分文字高亮,使用一对反引号。 90 语法: 91 ``` 92 `linux` `网络编程` `socket` `epoll` 93 ``` 94 效果:`linux` `网络编程` `socket` `epoll` 95 96 也适合做一篇文章的tag 97 #### 换行 98 直接回车不能换行, 99 可以在上一行文本后面补两个空格, 100 这样下一行的文本就换行了。 101 102 或者就是在两行文本直接加一个空行。 103 104 也能实现换行效果,不过这个行间距有点大。 105 #### 斜体、粗体、删除线 106 107 |语法|效果| 108 |----|-----| 109 |`*斜体1*`|*斜体1*| 110 |`_斜体2_`| _斜体2_| 111 |`**粗体1**`|**粗体1**| 112 |`__粗体2__`|__粗体2__| 113 |`这是一个 ~~删除线~~`|这是一个 ~~删除线~~| 114 |`***斜粗体1***`|***斜粗体1***| 115 |`___斜粗体2___`|___斜粗体2___| 116 |`***~~斜粗体删除线1~~***`|***~~斜粗体删除线1~~***| 117 |`~~***斜粗体删除线2***~~`|~~***斜粗体删除线2***~~| 118 119 斜体、粗体、删除线可混合使用 120 121 图片 122 ------ 123 基本格式: 124 ``` 125 ![alt](URL title) 126 ``` 127 alt和title即对应HTML中的alt和title属性(都可省略): 128 - alt表示图片显示失败时的替换文本 129 - title表示鼠标悬停在图片时的显示文本(注意这里要加引号) 130 131 URL即图片的url地址,如果引用本仓库中的图片,直接使用**相对路径**就可了,如果引用其他github仓库中的图片要注意格式,即:`仓库地址/raw/分支名/图片路径`,如: 132 ``` 133 https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif 134 ``` 135 136 |#|语法|效果| 137 |---|---|---- 138 |1|`![baidu](http://www.baidu.com/img/bdlogo.gif "百度logo")`|![baidu](http://www.baidu.com/img/bdlogo.gif "百度logo") 139 |2|`![][foryou]`|![][foryou] 140 141 注意例2的写法使用了**URL标识符**的形式,在[链接](#链接)一节有介绍。 142 >在文末有foryou的定义: 143 ``` 144 [foryou]:https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif 145 ``` 146 147 链接 148 ------ 149 ### 链接外部URL 150 151 |#|语法|效果| 152 |---|----|-----| 153 |1|`[我的博客](http://blog.csdn.net/guodongxiaren "悬停显示")`|[我的博客](http://blog.csdn.net/guodongxiaren "悬停显示")| 154 |2|`[我的知乎][zhihu] `|[我的知乎][zhihu] | 155 156 语法2由两部分组成: 157 - 第一部分使用两个中括号,[ ]里的标识符(本例中zhihu),可以是数字,字母等的组合,标识符上下对应就行了(**姑且称之为URL标识符**) 158 - 第二部分标记实际URL。 159 160 >使用URL标识符能达到复用的目的,一般把全文所有的URL标识符统一放在文章末尾,这样看起来比较干净。 161 >>URL标识符是我起的名字,不知道是否准确。囧。。 162 163 ### 链接本仓库里的URL 164 165 |语法|效果| 166 |----|-----| 167 |`[我的简介](/example/profile.md)`|[我的简介](/example/profile.md)| 168 |`[Book](./Book)`|[Book](/Book)| 169 170 ### 图片链接 171 给图片加链接的本质是混合图片显示语法和普通的链接语法。普通的链接中[ ]内部是链接要显示的文本,而图片链接[ ]里面则是要显示的图片。 172 直接混合两种语法当然可以,但是十分啰嗦,为此我们可以使用URL标识符的形式。 173 174 |#|语法|效果| 175 |---|----|:---:| 176 |1|`[![weibo-logo]](http://weibo.com/linpiaochen)`|[![weibo-logo]](http://weibo.com/linpiaochen)| 177 |2|`[![](/img/zhihu.png "我的知乎,欢迎关注")][zhihu]`|[![](/img/zhihu.png "我的知乎,欢迎关注")][zhihu]| 178 |3|`[![csdn-logo]][csdn]`|[![csdn-logo]][csdn]| 179 180 因为图片本身和链接本身都支持URL标识符的形式,所以图片链接也可以很简洁(见例3)。 181 注意,此时鼠标悬停时显示的文字是图片的title,而非链接本身的title了。 182 > 本文URL标识符都放置于文末 183 184 ### 锚点 185 其实呢,每一个标题都是一个锚点,和HTML的锚点(`#`)类似,比如我们 186 187 |语法|效果| 188 |---|---| 189 |`[回到顶部](#readme)`|[回到顶部](#readme)| 190 191 不过要注意,标题中的英文字母都被转化为**小写字母**了。 192 > 以前GitHub对中文支持的不好,所以中文标题不能正确识别为锚点,但是现在已经没问题啦! 193 194 ## 列表 195 ### 无序列表 196 * 昵称:果冻虾仁 197 - 别名:隔壁老王 198 * 英文名:Jelly 199 200 ### 多级无序列表 201 * 编程语言 202 * 脚本语言 203 * Python 204 205 ### 有序列表 206 #### 一般效果 207 就是在数字后面加一个点,再加一个空格。不过看起来起来可能不够明显。 208 面向对象的三个基本特征: 209 210 1. 封装 211 2. 继承 212 3. 多态 213 214 215 #### 多级有序列表 216 和无序列表一样,有序列表也有多级结构: 217 218 1. 这是一级的有序列表,数字1还是1 219 1. 这是二级的有序列表,阿拉伯数字在显示的时候变成了罗马数字 220 1. 这是三级的有序列表,数字在显示的时候变成了英文字母 221 222 223 ### 复选框列表 224 - [x] 需求分析 225 - [x] 系统设计 226 - [x] 详细设计 227 - [ ] 编码 228 - [ ] 测试 229 - [ ] 交付 230 231 您可以使用这个功能来标注某个项目各项任务的完成情况。 232 > Tip: 233 >> 在GitHub的**issue**中使用该语法是可以实时点击复选框来勾选或解除勾选的,而无需修改issue原文。 234 235 ## 块引用 236 237 ### 常用于引用文本 238 #### 文本摘自《深入理解计算机系统》P27 239 令人吃惊的是,在哪种字节顺序是合适的这个问题上,人们表现得非常情绪化。实际上术语“little endian”(小端)和“big endian”(大端)出自Jonathan Swift的《格利佛游记》一书,其中交战的两个派别无法就应该从哪一端打开一个半熟的鸡蛋达成一致。因此,争论沦为关于社会政治的争论。只要选择了一种规则并且始终如一的坚持,其实对于哪种字节排序的选择都是任意的。 240 > **“端”(endian)的起源** 241 以下是Jonathan Swift在1726年关于大小端之争历史的描述: 242 “……下面我要告诉你的是,Lilliput和Blefuscu这两大强国在过去36个月里一直在苦战。战争开始是由于以下的原因:我们大家都认为,吃鸡蛋前,原始的方法是打破鸡蛋较大的一端,可是当今的皇帝的祖父小时候吃鸡蛋,一次按古法打鸡蛋时碰巧将一个手指弄破了,因此他的父亲,当时的皇帝,就下了一道敕令,命令全体臣民吃鸡蛋时打破较小的一端,违令者重罚。” 243 244 ### 块引用有多级结构 245 > 数据结构 246 >> 树 247 >>> 二叉树 248 >>>> 平衡二叉树 249 >>>>> 满二叉树 250 251 代码高亮 252 ---------- 253 在三个反引号后面加上编程语言的名字,另起一行开始写代码,最后一行再加上三个反引号。 254 ```Java 255 public static void main(String[]args){} //Java 256 ``` 257 ```c 258 int main(int argc, char *argv[]) //C 259 ``` 260 ```Bash 261 echo "hello GitHub" #Bash 262 ``` 263 ```javascript 264 document.getElementById("myH1").innerHTML="Welcome to my Homepage"; //javascipt 265 ``` 266 ```cpp 267 string &operator+(const string& A,const string& B) //cpp 268 ``` 269 表格 270 -------- 271 272 表头1 | 表头2| 273 --------- | --------| 274 表格单元 | 表格单元 | 275 表格单元 | 表格单元 | 276 277 | 表头1 | 表头2| 278 | ---------- | -----------| 279 | 表格单元 | 表格单元 | 280 | 表格单元 | 表格单元 | 281 282 ### 对齐 283 表格可以指定对齐方式 284 285 | 左对齐 | 居中 | 右对齐 | 286 | :------------ |:---------------:| -----:| 287 | col 3 is | some wordy text | $1600 | 288 | col 2 is | centered | $12 | 289 | zebra stripes | are neat | $1 | 290 291 ### 混合其他语法 292 表格单元中的内容可以和其他大多数GFM语法配合使用,如: 293 #### 使用普通文本的删除线,斜体等效果 294 295 | 名字 | 描述 | 296 | ------------- | ----------- | 297 | Help | ~~Display the~~ help window.| 298 | Close | _Closes_ a window | 299 300 #### 表格中嵌入图片(链接) 301 其实前面介绍图片显示、图片链接的时候为了清晰就是放在在表格中显示的。 302 303 | 图片 | 描述 | 304 | ---- | ---- | 305 |![baidu][baidu-logo] | 百度| 306 307 表情 308 ---------- 309 Github的Markdown语法支持添加emoji表情,输入不同的符号码(两个冒号包围的字符)可以显示出不同的表情。 310 311 比如`:blush:`,可以显示:blush:。 312 313 具体每一个表情的符号码,可以查询GitHub的官方网页[http://www.emoji-cheat-sheet.com](http://www.emoji-cheat-sheet.com)。 314 315 但是这个网页每次都打开**奇慢**。。所以我整理到了本repo中,大家可以直接在此查看[emoji](./emoji.md)。 316 317 diff语法 318 --------- 319 版本控制的系统中都少不了diff的功能,即展示一个文件内容的增加与删除。 320 GFM中可以显示的展示diff效果。使用绿色表示新增,红色表示删除。 321 322 其语法与代码高亮类似,只是在三个反引号后面写diff, 323 并且其内容中,以 `+ `开头表示新增,`- `开头表示删除。 324 325 效果如下: 326 327 ```diff 328 + 鸟宿池边树,僧敲月下门 329 - 鸟宿池边树,僧推月下门 330 ``` 331 332 333 334 -------------------------------- 335 [csdn]:http://blog.csdn.net/guodongxiaren "我的博客" 336 [zhihu]:https://www.zhihu.com/people/jellywong "我的知乎,欢迎关注" 337 [weibo]:http://weibo.com/linpiaochen 338 [baidu-logo]:http://www.baidu.com/img/bdlogo.gif "百度logo" 339 [weibo-logo]:/img/weibo.png "点击图片进入我的微博" 340 [csdn-logo]:/img/csdn.png "我的CSDN博客" 341 [foryou]:https://github.com/guodongxiaren/ImageCache/raw/master/Logo/foryou.gif
十年磨一剑,一剑破万法