使用 README.md 创建 GitHub Pages 时如何转义代码块内的 GitHub Actions 变量？

Question

我使用 GitHub Pages 功能，它通过使用存储库中的 README.md 文件创建 GitHub Pages 站点。除了一个问题之外，这种方法效果很好。在我的 README.md 文件中，我有一些代码块说明了 GitHub Actions 工作流程的使用，并且在代码块内部引用了

${{github.foo.bar}}

形式的 GitHub Actions 变量。这在 GitHub 的存储库页面上呈现得很好，但在相应的 GitHub Pages 站点中，变量消失了！这是来自我的一个存储库的实际示例。首先是 README.md 的相关部分，如 GitHub 存储库视图中所示：

现在 GitHub Pages 结果的相应部分：

如何防止这种情况发生？

我想过使用

$

引用

\

字符，但反斜杠出现在 README.md 视图中，因此可能会导致人们复制不正确的 GitHub Actions 代码。

Answer 1

我相信 Jekyll（GitHub Pages 使用的静态站点生成器）正在看到

{{stuff}}

并尝试扩展它（因为它使用

{{…}}

来内联变量）。您可以通过在 Markdown 文件中使用

{% raw %}{{…}}{% endraw %}

来阻止 Jekyll 执行此操作，但该文本将按原样显示在 GitHub 存储库主页上（其中将

README.md

显示为 HTMLified Markdown without 通过 Jekyll 表达式运行它）扩张）。我不知道有什么方法可以让

{{…}}

显示在 GitHub 存储库主页 和 呈现的 GitHub Pages 站点中:-(