Github Makedown 语法入门

2024-02-15 02:58
文章标签 入门 语法 github makedown

本文主要是介绍Github Makedown 语法入门,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

GitHub上创建GitHub项目,会包含了一个 README.md 文件,此文件编辑就会用到Markdown

本文将详细介绍Markdown文件(md文件)的语法。

 

本文示例开源项目,请见GitHub

https://github.com/mimvp/mimvp-markdown-syntax

 

1. 新建GitHub项目

文本以米扑科技的项目库为例:mimvp

新建项目链接:https://github.com/organizations/mimvp/repositories/new

github-makedown-yu-fa-ru-men-01

 

2. 查看创建项目

mimvp-markdown-syntax

github-makedown-yu-fa-ru-men-02

 

3. 下载编辑 README.md   

0) 克隆项目到本地

https://github.com/mimvp/mimvp-markdown-syntax.git

编辑好README.md文件后,再提交上传到GitHub,这种方式效率低。

 

推荐一种更快捷的编辑README.md方式,直接在Github上编辑(推荐

a)点击 README.md文件

b)点击下图红框,直接编辑

github-makedown-yu-fa-ru-men-03

 

1)Markdown 标题

markdown 支持两种标题的语法:Setext 和 atx 形式,两者也可以结合使用,效果更好!

a)Setext 形式

用底线的形式,利用 === (最高阶标题)和 ----- (第二阶标题)

Markdown 语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
米扑科技
========
官网 [http: //mimvp .com](http: //mimvp .com)
官网 <a target= "_blank" href= "http://mimvp.com" >http: //mimvp .com< /a >
米扑代理
--------
官网 [http: //proxy .mimvp.com](http: //proxy .mimvp.com)
米扑域名
--------
官网 <a target= "_blank" href= "http://domain.mimvp.com" >http: //domain .mimvp.com< /a >
米扑财富
--------
官网 <a href= "http://money.mimvp.com" target= "_blank" >http: //money .mimvp.com< /a >

Markdown 结果:

github-makedown-yu-fa-ru-men-04

 

b)atx 形式

用#号标识标题,最多六级标题(不支持七级、八级等标题,会直接显示出文字)

Markdown 语法:

1
2
3
4
5
6
7
8
9
标题示例
========
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

Markdown 结果:

github-makedown-yu-fa-ru-men-06

 

2)Markdown 代码块

代码块,以大于号(>)开头。若末尾不加换行符<br/>,则所有文字会连接在一起不会换行。

Markdown 语法:

1
2
3
4
5
6
Markdown 代码块
========
> 米扑科技,小而美,简而信,工匠艺术的互联网服务。 <br/>
> 米扑团队,来自百度、小米、创新工场、阿里,核心研发,实战经验丰富。 <br/>
> 米扑产品,已上线服务包括米扑代理、米扑域名、米扑支付、米扑财富、米扑博客等。 <br/>
> 米扑科技官网: [mimvp.com](http: //mimvp .com)

Markdown 结果:

github-makedown-yu-fa-ru-men-07

 

3)Markdown 引用块

引用块,以特殊引号(`)开头。注意:不是单引号,而是特殊引号,在键盘左上角的“esc”左下方的那个按键

Markdown 语法:

1
2
3
4
5
6
7
8
9
Markdown 引用块
========
米扑科技简介
```
米扑科技,小而美,简而信,工匠艺术的互联网服务。
米扑团队,来自百度、小米、创新工场、阿里,核心研发,实战经验丰富。
米扑产品,已上线服务包括米扑代理、米扑域名、米扑支付、米扑财富、米扑博客等。
米扑科技官网: mimvp.com
```

Markdown 结果:

github-makedown-yu-fa-ru-men-08

 

4)Markdown 代码高亮

代码高亮,以特殊引号(`)开头,并跟上代码语言,例如:python、java、javascript、ruby、perl、go、c、c++、bash等。

注意:不是单引号,而是特殊引号,在键盘左上角的“esc”左下方的那个按键

Markdown 语法:

1
2
3
4
5
6
7
8
9
10
11
Markdown 代码高亮
========
```python
#!/usr/bin/env python
# -*- coding:utf-8 -*-
if __name__ == "__main__" :
     echo "hello mimvp"
     print( "I love mimvp.com" )
```

Markdown 结果:

github-makedown-yu-fa-ru-men-09

 

5)Markdown 字体加粗

* 或 _,表示斜体

** 或 __,表示粗体

~~ 表示删除线

Markdown 语法:

1
2
3
4
5
6
7
8
9
Markdown 字体加粗
========
我爱 米扑科技  <br/>
我爱 *米扑科技*  (斜体) <br/>
我爱 _米扑科技_  (斜体) <br/>
我爱 **米扑科技**  (粗体) <br/>
我爱 __米扑科技__  (粗体) <br/>
我爱 ***米扑*科技**  (斜体 + 粗体) <br/>
我爱 ~~米扑科技~~  (删除线) <br/>

Markdown 结果:

github-makedown-yu-fa-ru-men-10

 

6)Markdown 无序列表

*(星号) +(加号) - (减号)表示无序列表

Markdown 语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Markdown 无序列表
========
*(星号)
--------
* 米扑科技
* 米扑代理
* 米扑域名
* 米扑财富
+(加号)
--------
+ 米扑科技
+ 米扑代理
+ 米扑域名
+ 米扑财富
-(减号)
--------
- 米扑科技
- 米扑代理
- 米扑域名
- 米扑财富

Markdown 结果:

github-makedown-yu-fa-ru-men-11

 

7)Markdown 有序列表

直接用1. xxx     2. xxx   3. xxx 编辑

Markdown 语法:

1
2
3
4
5
6
7
Markdown 有序列表
========
1. 米扑科技
2. 米扑代理
3. 米扑域名
4. 米扑财富

Markdown 结果:

github-makedown-yu-fa-ru-men-12

 

8)Markdown 插入链接

Markdown 插入链接,有两种方式:

方式1) [mimvp.com](http://mimvp.com)     

方式2)<a target="_blank" href="http://mimvp.com">mimvp.com</a>  (推荐

Markdown 语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
米扑科技
========
官网 [http: //mimvp .com](http: //mimvp .com)
官网 <a target= "_blank" href= "http://mimvp.com" >http: //mimvp .com< /a >
米扑代理
--------
官网 [http: //proxy .mimvp.com](http: //proxy .mimvp.com)
米扑域名
--------
官网 <a target= "_blank" href= "http://domain.mimvp.com" >http: //domain .mimvp.com< /a >
米扑财富
--------
官网 <a href= "http://money.mimvp.com" target= "_blank" >http: //money .mimvp.com< /a >

Markdown 结果:

github-makedown-yu-fa-ru-men-04

 

9)Markdown 插入图片

Markdown 插入图片有两种方式:

方式1) ![mimvp-logo.png](./mimvp-logo.png)

方式2) <img src="./mimvp-logo.png" title="mimvp-logo.png" />    

Markdown 语法:

1
2
3
4
5
6
7
8
9
Markdown 插入图片
========
### 1. 米扑科技(默认)
![mimvp-logo.png](. /mimvp-logo .png)
### 2. 米扑科技(img)
<img src= "./mimvp-logo.png" title= "mimvp-logo.png" />    

Markdown 结果:

github-makedown-yu-fa-ru-men-13

 

10)Markdown 表格

Makrdown 支持table表格,语法跟wiki类似。同时,也支持table标签

方式1

Markdown 语法:

1
2
3
4
5
6
7
8
Markdown 表格
========
|产品|网址|年份|
|----|-----|-----|
|米扑代理|[proxy.mimvp.com](http: //proxy .mimvp.com)|2014|
|米扑域名|[domain.mimvp.com](http: //domain .mimvp.com)|2015|
|米扑支付|[pay.mimvp.com](http: //pay .mimvp.com)|2016|
|米扑财富|[money.mimvp.com](http: //money .mimvp.com)|2017|

Markdown 结果:

github-makedown-yu-fa-ru-men-14

方式2

Markdown 语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<table>
< tr >
<td colspan= "3" color= "red" >米扑产品< /td >
< /tr >
< tr >
<td>米扑代理< /td >
<td>http: //proxy .mimvp.com< /td >
<td>2014< /td >
< /tr >
< tr >
<td>米扑域名< /td >
<td>http: //domain .mimvp.com< /td >
<td>2015< /td >
< /tr >
< tr >
<td>米扑支付< /td >
<td>http: //pay .mimvp.com< /td >
<td>2016< /td >
< /tr >
< tr >
<td>米扑财富< /td >
<td>http: //money .mimvp.com< /td >
<td>2017< /td >
< /tr >
< /table >

Markdown 结果:

github-makedown-yu-fa-ru-men-15

 

11)Markdown 多选项

多选项,结合了多种元素,如无序列表减号(-),方括号等

Markdown 语法:

1
2
3
4
5
6
7
8
9
Markdown 多选项
========
米扑产品包含?
- [x] 米扑代理
- [x] 米扑域名
- [x] 米扑支付
- [x] 米扑财富
- [ ] 米扑基金
- [ ] 米扑期货

Markdown 结果:

github-makedown-yu-fa-ru-men-16

 

12)Markdown emoji表情

 

Markdown 语法:

1
2
3
4
Markdown emoji
========
@mimvp is :+1: This PR looks great - I love mimvp.com  :smiley:

Markdown 结果:

github-makedown-yu-fa-ru-men-17

 

13)Markdown diff 高亮对比

diff 语法是代码高亮语法的一种,以 `+ `开头表示新增,`- `开头表示删除。

Markdown 语法:

1
2
3
4
5
6
Markdown diff 高亮对比
----------
``` diff
+ 增加 emoji.md
- 删除 emoji.txt
```

Markdown 结果:

github-makedown-yu-fa-ru-men-18

 

14)Markdown 其它知识

知识1:  [回到顶部](#readme)

知识2: 版本符号 &copy;

Markdown 语法:

1
2
3
4
5
Markdown 其它知识
----------
|`[回到顶部]( #readme)`|[回到顶部](#readme)|
|`版本符号 &copy;`|&copy;|

Markdown 结果:

github-makedown-yu-fa-ru-men-19

 

15)Markdown 版权格式

一般开源项目,末尾会追加一些开原作者的信息,例如米扑科技的作者信息如下,供参考。

Markdown 语法:

1
2
3
4
5
6
米扑科技
----------
<img src= "./mimvp-logo.png" title= "mimvp-logo.png" />
All Right &copy; [mimvp.com](http: //mimvp .com)   :blush:

Markdown 结果:

github-makedown-yu-fa-ru-men-20

 

本文Markdown示例,请见米扑科技的 GitHub:

https://github.com/mimvp/mimvp-markdown-syntax

 


这篇关于Github Makedown 语法入门的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/710277

相关文章

从入门到精通MySQL联合查询

《从入门到精通MySQL联合查询》:本文主要介绍从入门到精通MySQL联合查询,本文通过实例代码给大家介绍的非常详细,需要的朋友可以参考下... 目录摘要1. 多表联合查询时mysql内部原理2. 内连接3. 外连接4. 自连接5. 子查询6. 合并查询7. 插入查询结果摘要前面我们学习了数据库设计时要满

从入门到精通C++11 <chrono> 库特性

《从入门到精通C++11<chrono>库特性》chrono库是C++11中一个非常强大和实用的库,它为时间处理提供了丰富的功能和类型安全的接口,通过本文的介绍,我们了解了chrono库的基本概念... 目录一、引言1.1 为什么需要<chrono>库1.2<chrono>库的基本概念二、时间段(Durat

解析C++11 static_assert及与Boost库的关联从入门到精通

《解析C++11static_assert及与Boost库的关联从入门到精通》static_assert是C++中强大的编译时验证工具,它能够在编译阶段拦截不符合预期的类型或值,增强代码的健壮性,通... 目录一、背景知识:传统断言方法的局限性1.1 assert宏1.2 #error指令1.3 第三方解决

从入门到精通MySQL 数据库索引(实战案例)

《从入门到精通MySQL数据库索引(实战案例)》索引是数据库的目录,提升查询速度,主要类型包括BTree、Hash、全文、空间索引,需根据场景选择,建议用于高频查询、关联字段、排序等,避免重复率高或... 目录一、索引是什么?能干嘛?核心作用:二、索引的 4 种主要类型(附通俗例子)1. BTree 索引(

Redis 配置文件使用建议redis.conf 从入门到实战

《Redis配置文件使用建议redis.conf从入门到实战》Redis配置方式包括配置文件、命令行参数、运行时CONFIG命令,支持动态修改参数及持久化,常用项涉及端口、绑定、内存策略等,版本8... 目录一、Redis.conf 是什么?二、命令行方式传参(适用于测试)三、运行时动态修改配置(不重启服务

MySQL DQL从入门到精通

《MySQLDQL从入门到精通》通过DQL,我们可以从数据库中检索出所需的数据,进行各种复杂的数据分析和处理,本文将深入探讨MySQLDQL的各个方面,帮助你全面掌握这一重要技能,感兴趣的朋友跟随小... 目录一、DQL 基础:SELECT 语句入门二、数据过滤:WHERE 子句的使用三、结果排序:ORDE

github打不开的问题分析及解决

《github打不开的问题分析及解决》:本文主要介绍github打不开的问题分析及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、找到github.com域名解析的ip地址二、找到github.global.ssl.fastly.net网址解析的ip地址三

Python中OpenCV与Matplotlib的图像操作入门指南

《Python中OpenCV与Matplotlib的图像操作入门指南》:本文主要介绍Python中OpenCV与Matplotlib的图像操作指南,本文通过实例代码给大家介绍的非常详细,对大家的学... 目录一、环境准备二、图像的基本操作1. 图像读取、显示与保存 使用OpenCV操作2. 像素级操作3.

mysql递归查询语法WITH RECURSIVE的使用

《mysql递归查询语法WITHRECURSIVE的使用》本文主要介绍了mysql递归查询语法WITHRECURSIVE的使用,WITHRECURSIVE用于执行递归查询,特别适合处理层级结构或递归... 目录基本语法结构:关键部分解析:递归查询的工作流程:示例:员工与经理的层级关系解释:示例:树形结构的数

POI从入门到实战轻松完成EasyExcel使用及Excel导入导出功能

《POI从入门到实战轻松完成EasyExcel使用及Excel导入导出功能》ApachePOI是一个流行的Java库,用于处理MicrosoftOffice格式文件,提供丰富API来创建、读取和修改O... 目录前言:Apache POIEasyPoiEasyExcel一、EasyExcel1.1、核心特性