GitHub 风味 Markdown

GitHub.com 使用自己版本的 Markdown 语法，该语法提供了一组额外的有用功能，其中许多功能可以更轻松地使用 GitHub.com 上的内容。

注意，GitHub 风味 Markdown 的某些功能仅在 Issues 和拉取请求的说明和注释中提供。这些包括@提及以及对 SHA-1 哈希、Issues 和拉取请求的引用。任务列表也可以在 Gist 评论和 Gist Markdown 文件中使用。

语法高亮

以下是如何使用 GitHub 风味 Markdown 进行语法高亮的示例：

```javascript
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

你还可以简单地将代码缩进四个空格：

```text
    function fancyAlert(arg) {
      if(arg) {
        $.facebox({div:'#foo'})
      }
    }

以下是没有语法高亮的 Python 代码示例：

def foo():
    if not bar:
        return True

任务列表

- [x] 支持@提及、#引用、[链接]()、**格式化**、和 <del>标签</del>
- [x] 需要列表语法（支持任何无序或有序列表）
- [x] 这是一个已完成事项
- [ ] 这是一个未完成事项

如果你在 Issue 的第一条评论中包含任务列表，你将在问题列表中获得一个方便的进度指示器。 它也适用于拉取请求！

表格

你可以通过组合单词列表并用连字符 - 分隔（第一行），然后用管道符 | 分隔每个列创建表格：

标题一 | 标题二
----- | -----
第一格内容 | 第二格内容
第一列内容 | 第二列内容

会变成：

标题一	标题二
第一格内容	第二格内容
第一列内容	第二列内容

SHA 引用

对提交的 SHA-1 哈希 的任何引用都将自动转换为 GitHub 上对应提交的链接。

16c999e8c71134401a78d4d46435517b2271d6ac
mojombo@16c999e8c71134401a78d4d46435517b2271d6ac
mojombo/github-flavored-markdown@16c999e8c71134401a78d4d46435517b2271d6ac

仓库内引用 Issue

任何引用 Issue 或拉取请求的编号都将自动转换为链接。

#1
mojombo#1
mojombo/github-flavored-markdown#1

用户名 @提及

输入 @ 符，后跟用户名，将通知该用户来查看评论。这被称为“@提及”，因为你_提及_了某个人。你还可以在组织内@提及团队。

自动链接 URLs

任何 URL（如 http://www.github.com/）都将自动转换为可点击的链接。

删除线

用两个波浪号包裹的任何单词（比如 ~~这个~~）都会显示出删除线。

Emoji

GitHub 支持 emoji！

要查看我们支持的所有图片的列表，请查看 Emoji 速查表。