用markdown语法写GitHub上README文件

这篇文章是本人平时的一些笔记,可能会有很多人写过相关的东西,而且更为全面。目的只是分享一些自己平时的东西,勿喷!!!!

README文件

README文件可能大家都不会陌生,在我们上传一些自己的工程文件到GitHub时,附加的一个说明文档,会显示在仓库的详情中。使用markDown语法编写可以让其看起来更加清晰明朗一些。

具体的相关语法说明

readme文件的创建和编辑在这里就不多介绍了,相信使用过git的朋友们应该不会陌生。下面是一些常用的语法:

1.标题

首先是大标题,大标题是在作为标题的文字下面添加=号,个数不限;
其次是中标题,中标题在作为标题的文字下面添加-号,个数不限;
最后是各级小标题,分为六级,#号开头 ,每多一级多一个#号,比如:一级标题是#,二级标题是##,以此类推下去。下面是相关的效果展示:

大标题

中标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

+++++++手动分割线+++++++++

2.文本

首先是普通文本,文本主要是换行符,"< br >"(去掉空格)或者是双空格加回车,如下:
这是一条可以换行的话,
这里是使用换行符换行。
这里是使用双空格加回车换行

然后是单行和多行文本, 使用两个Tab符实现单行文本;多行文本和单行文本异曲同工,只要在每行行首加两个Tab,比如
hello,swift
亲爱的领导:
你好!
再见

最后是文本的格式化和插入:

字体高亮:

把需要设置的字体用包围,是Tab上方,数字1左边的按键。如下:
窗前明月光,疑是上霜

粗体和斜体:

用两个 星号 包含一段文本就是粗体的语法,用一个星号包含一段文本就是斜体的语法。
头望明月,低头思故乡

引用:

在引用的句子前面加上 > 号即可:

静夜思
窗前明月光,
疑是地上霜。
举头望明月,
低头思故乡。

文本超链接:

格式是: [ 要显示的文字 ]( 链接的地址 ** "悬浮显示")** ,还可以给他加上一个鼠标悬停显示的文本,就像css中的hover属性。如下:
百度一下

列表:

无序列表的话,你只需要在文字前面加上 - + 空格 就可以了,有序列表的话就在前面加上1. 2. 3等;圆点符的话,加上*号。如果想要分级的话在每一级前面加个tab键即可, 如下:
无序列表:

  • 无序1
  • 无序2
  • 无序3

有序列表:

  1. 无序1
  2. 无序2
  3. 无序3

圆点符:

  • 文本
  • 文本
  • 文本

分级列表:

  • 文本
    • 文本
      • 文本
插入图片,添加图片链接

叹号! + 方括号[ ] + 括号( ) 其中括号里是图片的URL。在方括号里可以加入一些 标识性的信息


baidu
代码引用

这个对开发者可能比较有用处:
需要引用代码时,如果引用的语句只有一段,不分行,可以用 (tab键上面的,1键旁边的键位)将语句包起来。如果引用的语句为多行,可以将三个(tab键上面的,1键旁边的键位)置于这段代码的首行和末行。
var name = "hello , wrold"

if let removedValue = airports.removeValueForKey("DUB"){
    print("The removed airport's name is (removedValue).")
} else {
    print("The airports dictionary does not contain a value for DUB.")
}// prints "The removed airport's name is Dublin Airport." 

结语:

简书也自带markdown功能,编辑起来很方便。上面只是一些简单的操作,还有一些复杂的语法规则如果平时用到的话,可以自行在网上查询。markdown对撰写blog还是蛮实用和重要的!!!希望能帮到大家。。加油!!!

这里有一篇参考的博客和一个应用实例的链接:

献给写作者的 Markdown 新手指南
REDEME实例

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,667评论 5 472
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,361评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,700评论 0 333
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,027评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,988评论 5 361
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,230评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,705评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,366评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,496评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,405评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,453评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,126评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,725评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,803评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,015评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,514评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,111评论 2 341

推荐阅读更多精彩内容