如何在 markdown github gist 中使用 PHP 中的语法高亮显示？答案

【问题标题】：How do I use syntax highlighting in PHP within a markdown github gist?如何在 markdown github gist 中使用 PHP 中的语法高亮显示？
【发布时间】：2014-02-12 13:55:37
【问题描述】：

我想在markdown gist on github 中包含代码，但不知道如何进行语法高亮显示。

github 风格的降价 - 例如

```php
    Class::function($param);
```

例如，会在问题中将语法突出显示为 php，但它似乎不是要点。

【问题讨论】：

标签： php syntax-highlighting markdown gist

【解决方案1】：

Fenced 代码块确实可以在 Markdown Gists 中工作，实际上您的代码正在以这种方式呈现。如果您检查这些块，您会发现它们包含在 divs 和 class="highlight highlight-PHP" 中。

问题在于 PHP 代码只有在包含 <?php 分隔符时才能被 GFM 识别为突出显示（很像 PHP 代码只在 <?php 块内运行）。将此添加到每个 PHP 代码块的顶部，您应该可以开始使用，例如：

...

```php
<?php
class GO_Example_Model_Thing extends GO_Base_Db_ActiveRecord {
    ...

【讨论】：

【解决方案2】：

在块之前使用此 HTML 注释标记：

     
<!-- language: php -->

然后是您的代码块和其余的答案/问题：

     
    Class::function($param);
    // more code...

重要规则：

不要缩进 HTML 注释。
在注释后输入一个新的空行。
如果不起作用，请在注释和缩进代码之前插入一个新的空行。

您可以查看Stack Overflow's Markdown help 和更详细的meta's answer。

【讨论】：

这适用于 Stack Overflow，但不适用于 GitHub。（此外，已经为 OP 正确检测到语言，如 class="highlight highlight-PHP" 属性所示。）
我没有意识到这个问题集中在GitHub上，我没有读好就回答了。感谢@chris 的评论，指出我的错误比匿名投反对票更明智。