Github上的Markdown语法详解

今天在看Win32文档参与编写的说明时,看到里面提及

复制代码
Our documentation is written in Markdown, a lightweight text style syntax. If you're not familiar with Markdown, you can learn the basics on GitHub. When unsure,

刚好,今天就来做个全面的总结 ,以后在github上写说明的时候,就更方便了。

标题

输入 # 空格 文本,就可以创建标题,如:

# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

文本样式

样式 语法 快捷键 示例 输出
加粗 ** ** 或者 __ __ Ctrl+B **加粗** 加粗
斜体 * * 或者 _ _ Ctrl+I *斜体* 斜体
删除线 ~~ ~~ ~~删除文本~~ 删除文本
加粗嵌套斜体 ** ** 和 _ _ **加粗中的_斜体_** 加粗中的_斜体_(博客园Markdown编辑器不支持这种格式,看不到显示效果)
加粗并斜体 *** *** ***加粗并斜体*** 加粗并斜体
下标 普通文本<sub>下标</sub> 普通文本下标
上标 普通文本<sup>上标</sup> 普通文本上标

引用文本

输入 > 空格 引用文本

> 引用文本

引用文本

引用代码

输入 'code'```code```

Hello `World`

Hello World

```

Hello World

```

Hello World

语法高亮

```后输入语言名称 即可,完整的语言列表可以访问 https://github.com/github/linguist

```

Console.WriteLine("HelloWorld");

```

Console.WriteLine("HelloWorld");

```c#

Console.WriteLine("HelloWorld");

```

Console.WriteLine("HelloWorld");

颜色显示(支持 issues, pull requests, 和 discussions,说明文档是不支持这种语法格式的)

颜色模式 语法 示例 输出
HEX #RRGGBB 红色`#ff0000` 红色ff0000
RGB rgb(R,G,B) 黑色`rgb(0, 0, 0)` 黑色rgb(0, 0, 0)
HSL hsl(H,S,L) 白色`hsl(216, 0%, 100%)` 白色hsl(216, 0%, 100%)

超链接

输入 [显示内容](链接地址)

[博客园](https://www.cnblogs.com)

博客园

链接到段落

如果我们想链接到文中的某一个位置。如下图所示。可以复制前面那个链接图标的地址

然后创建一个链接,如下:

[实用工具](https://github.com/zhaotianff/Master-Zhao#实用工具)

实用工具

链接到项目文件

如果我们想链接到项目中的某一个文件,直接指定相对路径即可。以当前md文档所在的路径为根目录。./为当前目录../为上级目录../../为上上级目录 ,依此类推。xx/ 或**./xx/** 为当前路径下的xx目录,a/b 或**./a/b** 为当前a目录下的b目录,依此类推。

比如常用的开源协议文件,一般都会创建一个这样的链接,代表链接到当前路径下的LICENSE文件

[CC0-1.0](./LICENSE).

[CC0-1.0](LICENSE).

图片

输入 ![替代文本](图片地址) 就可以插入图片,图片地址可以是一个网络地址,也可以是当前项目下的。

![alt text](https://img2.baidu.com/it/u=3155456000,3342398460&fm=253&fmt=auto&app=138&f=JPG?w=387&h=500)
![logo](icon/logo.png)

但是这种方式有个缺点,就是图片不能居中,如果想要图片居中,可以使用p和img标签

<p align="center">
    <img alt="alt text" src="https://img2.baidu.com/it/u=3155456000,3342398460&fm=253&fmt=auto&app=138&f=JPG?w=387&h=500" />
</p>

列表

输入 * 空格 列表项- 空格 列表项

* 列表项1
* 列表项2
  • 列表项1

  • 列表项2

    • 列表项1
    • 列表项2
  • 列表项1

  • 列表项2

列表嵌套

列表嵌套也是使用跟创建列表一样的语法,但是嵌套符号要和上级列表的首字符对齐。

如嵌套列表的*是和上面的"列"字是对齐的

* 列表
  * 嵌套列表1
    * 嵌套列表2
  • 列表
    • 嵌套列表1
      • 嵌套列表2

数字列表

也可以创建数字列表,输入 数字. 空格 列表项

如:

1. 列表项1
2. 列表项2
   * 嵌套列表项
  1. 列表项1
  2. 列表项2
    • 嵌套列表项

任务列表

使用 - [x] 任务描述 创建一个完成项,使用 - [ ] 任务描述 创建一个未完成项。

- [x] 已完成
- [ ] 未完成
- [ ] https://github.com/TianXiaTech/BlurWindow/issues/2

使用emoji

输入 :emoji代码: 就可以插入emoji

如:

:+1::+1:

👍👍

添加脚注

输入 [^脚注名称][^脚注名称]:说明 创建一个脚注

测试脚注[^1]

[^1]:脚注说明

实际效果

测试脚注[1]

注释

输入 "<!--需要注释的内容-->"

忽略Markdown格式

在Markdown标记字符输入 \ 即可

如:

# 一级标题
\# 一级标题

一级标题

一级标题


  1. 脚注说明 ↩︎
相关推荐
Stara051113 小时前
Git推送+拉去+uwsgi+Nginx服务器部署项目
git·python·mysql·nginx·gitee·github·uwsgi
不能只会打代码17 小时前
大学课程项目中的记忆深刻 Bug —— 一次意外的数组越界
java·github·intellij-idea·话题博客
Web极客码1 天前
如何修复WordPress卡在维护模式
服务器·网络·github
油泼辣子多加1 天前
2024年11月17日Github流行趋势
github
海里有太阳1 天前
gitHub常用操作
github
量子孤岛1 天前
建立独一无二的GitHub Profile
github
小小宇宙中微子2 天前
QDUOJ(青岛大学在线评测系统)
github
Smilejudy2 天前
从 ES Kafka Mongodb Restful ... 取到 json 之后
后端·github
明天最后2 天前
由于Two-Factor Authentication导致github发布npm包失败
前端·npm·github
n***85942 天前
GitHub 开源项目 Puter :云端互联操作系统
github