我可以在 github 中显示 asciidoc 文档吗?

Can I display asciidoc document in github?

我能否在 github 上以与当前查看 markdown 文件相同的方式显示 asciidoc 文件?根据这个博客entry,我应该可以做到:

If you’re interested in using AsciiDoc, head over to GitHub and create a new file in one of your repositories or gists using the file extension .asciidoc or .adoc.

但是我尝试这样做,但没有成功。谁能告诉我如何获取 asciidoc 文档以在 Github 上显示格式良好的文本?

这是我试图用 Asciidoc 测试的文档。 https://github.com/00krishna/proj_blog/blob/master/test.adoc

您的文件在语法上无效(或者该行被视为纯文本)。

您的原始文件:

==This is a test
this is a test of using asciidoc

==后面没有space;我认为这是必需的。

正确显示的修改版本:

== This is a test
this is a test of using asciidoc

参见 this Gist 中的 test.adoctest2.adoc

此功能的语法 "One line titles" 记录在 Asciidoc user guide, section 11.2

作为已接受答案的补充,Github(或至少 Github 的 Wiki 部分)仅接受 .asciidoc 后缀。 .adoc.ad 似乎不起作用。我之所以遇到这个,是因为我试图手动将 wiki 中的页面从 .md 更改为 .ad,但它们不会呈现,所以如果您的问题仍然存在,请检查此内容。