我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2020-11-12. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

创建和突显代码块

通过围栏代码块和启用语法突显来分享代码样本

本文内容

围栏代码块

通过在代码块的前后输入三反引号 ```,可创建围栏代码块。 我们建议在代码块的前后各留一个空白行,使原始格式更易辨读。

```
function test() {
  console.log("notice the blank line before this function?");
}
```

渲染的围栏代码块

提示:要在列表中保留格式,请确保将非围栏代码块缩进八个空格。

语法突显

您可以添加可选的语言标识符,以在围栏代码块中启用语法突显。

例如,要语法突显 Ruby 代码:

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
puts markdown.to_html
```

渲染的启用 Ruby 语法突显的代码块

我们使用 Linguist 来执行语言检测并选择第三方语法进行语法突显。 您可以在语言 YAML 文件中找出哪些关键词有效。.

延伸阅读