Официальная ссылка на синтаксис asciidoc в github

Question

Я пытаюсь создать документацию, используя asciidoc;В настоящее время работает с расширением кода Visual Studio joaompinto.asciidoctor-vscode.Но при загрузке файлов в github git, похоже, игнорирует большинство форматов.Например, я уже сталкивался с тем, что github не поддерживает включение и размещение списка в блоке

====

* Entry1

* Entry2

====

не создает никаких форматирующих группировок этого списка в контейнере.

Есть ли какие-либодокументация для asciidoc, описывающая только те вещи, которые могут быть использованы github?

Answer 1

Я не знаю, поможет ли это, но у меня была похожая проблема с оглавлением asciidoc в github, и я нашел следующую страницу:

https://github.com/opendevise/asciidoc-samples/blob/master/demo.adoc

необработанная страница доступна здесьдля примеров синтаксиса:

https://raw.githubusercontent.com/opendevise/asciidoc-samples/master/demo.adoc

и это действительно помогло.