GItHub----Makedown语法学习(快速入门)

原创 2016年06月01日 15:24:55

    在GitHub上创建GitHub项目应该大家都会,新建的项目包含了一个 README.md 文件,这个文件的编辑就会用到Markdown的编写.接下来我将记录一下md文件从创建到编写的过程,在这个过程中就会用到Markdown语法。   

一、创建一个空白GitHub项目。



     在GITHub创建一个项目需要填写如上的几部分,点击“Create”这样我们就拥有了一个 GitHub 项目如下


  可以看到这个项目只包含了一个 README.md 文件,这里提一下 README.md ,GitHub 上所有关于项目的详介绍以及 Wiki 都是基于 Markdown 的,那么接下来就学习一下Markdown(入门级)语法。

二、Markdown: Basics (快速入门)语法学习

2.1  段落、标题、区块代码

2.1.1 段落

    一个段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示上看起来像是空行,就被视为空行,例如有一行只有空白和 tab,那该行也会被视为空行),一般的段落不需要用空白或换行缩进。

2.1.2 标题

markdown 支持两种标题的语法,Setext 和 atx 形式。
Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)


运行效果

  Atx 形式在行首插入 # 即可,同理可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加  # 即可,标题字号相应降低


## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 




运行效果


2.1.3 代码块

区块引用则使用 email 形式的 '>' 角括号。
测试代码块


> Markdown 支持两种标题的语法,Setext 和 atx 形式

> Markdown 支持两种标题的语法,Setext 和 atx 形式
> Markdown 支持两种标题的语法,Setext 和 atx 形式

显示结果为



  加入换行显示,有两种方式一种是加入空白行,另外一种是加入“>”符号
  例如

  
>
> 带符号换行Markdown 支持两种标题的语法,Setext 和 atx 形式
> Markdown 支持两种标题的语法,Setext 和 atx 形式
> Markdown 支持两种标题的语法,Setext 和 atx 形式
> 空白换行


运行效果如下:


 

2.2 修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。
例如


他是最可爱的人*雷锋*(斜体)

他是最可爱的人_雷锋_ (斜体)
他是最可爱的人**雷锋**(加粗)
他是最可爱的人 __雷锋__(加粗)


运行效果为


2.3  列表标记

   2.3.1 无序的标记(用* + - 号)

       
* Candy.
* Gum.
* Booze.
> 加号:
+ Candy.
+ Gum.
+ Booze
> 减号
- Candy.
- Gum.
- Booze.
运行效果

 2.3.2 有序的标记

    
有序的列表则是使用一般的数字接着一个英文句点作为项目标记(.与内容之间加空格)

1.红色
2.蓝色
3.紫色
4.黄色


运行效果


2.4  链接和图片 

   Markdown 支援两种形式的链接和图片语法: 行内 和 参考 两种形式,两种都是使用角括号来把文字转成连结。

  2.4.1 行内模式

     行内形式是直接在后面用括号直接接上链接:


例如


[个人博客](http://blog.csdn.net/blueamertj)

> 祝大家61快乐(插入图片)
![61儿童](http://www.astiron.com/data/upload/image/201506/7748386409f3a7206cb4d7dfa24c78ce.jpg)
运行效果:



2.4.2 参考模式

参考形式的链接让你可以为链接定一个名称,之后你可以在文件的其他地方定义该链接的
例如


我喜欢的网站有[百度][1]和
[好123][2] or [GitHub][3].
[1]: http://baidu.com/ "baidu"
[2]: http://www.hao123.com/ "好123"
[3]: https://github.com/ "GitHub"
图片 参考形式:
![61][2]
[1]:http://www.astiron.com/data/upload/image/201506/7748386409f3a7206cb4d7dfa24c78ce.jpg
运行效果:

2.5 表格 

代码如下


|姓名|所在地|产品|

| ----|-----|-----|
|雷军|北京 |小米手机|
|老罗|北京|锤子手机|
|任正非|深圳|华为手机|


运行效果




  

注:洗完这篇文章后,发现CSDN博客发表文章可以切换到MarkDown编辑器,用法说明也非常详细.去往说明




GitHub上README写法暨GFM语法解读

自从开始玩GitHub以来,就越来越感觉它有爱。最近对它的README.md文件颇为感兴趣。便写下这贴 README文件后缀名为md。md是markdown的缩写,markdown是一种编辑博客的语言...

Markdown 语法手册 (完整整理版)

转载:http://blog.leanote.com/post/freewalk/Markdown%E8%AF%AD%E6%B3%95%E6%89%8B%E5%86%8C 0. 目录 0...

github上ReadMe语法

原文地址:http://guoyunsky.iteye.com/blog/1781885 大标题   ===================================   ...

MakeDown最基本用法,亲测有效

1.设置标题最主要的方法是在文字前面加上#,不同的#号代表不同的标题大小2.加空格makedown对于空格是自动省略的 可以使用 “  ;” 最后的分号是紧跟着的 eg:空  格 3....

Delphi7高级应用开发随书源码

  • 2003年04月30日 00:00
  • 676KB
  • 下载

makedown使用

官方指引 标题 标题前使用#,#的数量代表标题级数,依次可为1~6级,也就是1~6个# 例如:一级标题“#标题1”、二级标题“##标题2” 列表 无序列表前面使用减号,与减号之间也有个空格,若是...

转:Solr学习总结-Facet(各种例子,包括facet.query的使用)

http://www.fx114.net/qa-213-598845.aspx 本篇文章主要介绍了"Solr学习总结-Facet",主要涉及到Solr学习总结-Facet方面的内容,对于So...

如何才能成为一名真正的Web程序员

程序员可以分为很多种,像Unix程序员、Windows程序员,或是C++程序员、Delphi程序员,等等。今天我想谈的是Web程序员,一名真正的Web程序员应该懂得那些方面的知识,应该注意学习哪些东西...

GitHub:(1) 官方快速入门文档学习

账号注册: It is so easy for erveryone, so we omitted this step here. 官方快速入门文档学习:Read the Guide. GitHub...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:GItHub----Makedown语法学习(快速入门)
举报原因:
原因补充:

(最多只允许输入30个字)