Markdown 额外语法支持 - GitHub Flavored Markdown

2022-05-17 17:50:16 浏览数 (1)

Syntax highlighting 语法突显

下面是一个例子,告诉你如何使用 GitHub 语法突显标记:

代码语言:javascript复制
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

您也可以简单地将代码缩进四个空格:

代码语言:javascript复制
    function fancyAlert(arg) {
      if(arg) {
        $.facebox({div:'#foo'})
      }
    }

Task Lists 任务清单

代码语言:javascript复制
- [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> supported
- [x] list syntax required (any unordered or ordered list supported)
- [x] this is a complete item
- [ ] this is an incomplete item

如果您在问题的第一个注释中包含了一个任务列表,那么您将在问题列表中得到一个方便的进度指示器。 它也可以在 Pull Requests 中工作!

Tables 表格

您可以通过组合一个单词列表并用连字符-(对于第一行)划分它们,然后用管道 | 分隔每一列来创建表:

代码语言:javascript复制
First Header | Second Header
------------ | -------------
Content from cell 1 | Content from cell 2
Content in the first column | Content in the second column

Would become:

First Header

Second Header

Content from cell 1

Content from cell 2

Content in the first column

Content in the second column

SHA references

任何对提交的 SHA-1散列的引用都会自动转换为 GitHub 上提交的链接。

代码语言:javascript复制
16c999e8c71134401a78d4d46435517b2271d6ac
mojombo@16c999e8c71134401a78d4d46435517b2271d6ac
mojombo/github-flavored-markdown@16c999e8c71134401a78d4d46435517b2271d6ac

Issue references within a repository

任何引用发布或拉请求的号码都将自动转换为链接。

代码语言:javascript复制
#1
mojombo#1
mojombo/github-flavored-markdown#1

Username @mentions

输入一个@符号,后面跟着一个用户名,会通知那个人来查看评论。 这被称为“@mention” ,因为你提到的是个人。 你也可以@提及组织中的团队。

Automatic linking for URLs

任何 URL (如 http://www.github.com/ 链接)都会自动转换成可点击的链接。

Strikethrough 删除

任何带有两个波浪线的单词(比如~~this~~)都会被划掉。

Emoji 表情符号

GitHub 支持表情符号 emoji !

要查看我们支持的所有图片,请查看 Emoji Cheat Sheet.

跳转到标题锚点

先定义一个#标题, 然后可以用[abcd...](#该标题)来定位该锚点

代码语言:javascript复制
* [1 前言](#1-前言)

## 1 前言

效果:

image.png

参考

Mastering Markdown · GitHub Guides https://guides.github.com/features/mastering-markdown/#GitHub-flavored-markdown

0 人点赞