寻求可在流水线中使用的基础Asciidoc语法检查工具

推荐工具 #

• Asciidoctor Lint: 专门针对 Asciidoc 的语法检查工具，能识别诸如「标题使用 # 而非 =」这类基础语法错误，还能检测未闭合的代码块、格式不规范的标记等问题，完全匹配你在 IntelliJ 中得到的提示类型。
  • 安装方式：gem install asciidoctor-lint
  • 执行检查：asciidoctor-lint ./path/to/your/doc.adoc
• Asciidoctor CLI 严格模式: 官方的 Asciidoctor 工具自带严格模式，开启后会直接抛出语法错误提示，包括错误的标题符号使用。
  • 执行命令：asciidoctor --strict ./path/to/your/doc.adoc

流水线集成建议 #

• 将上述检查命令添加为 CI 流水线的一个步骤（比如 GitHub Actions、GitLab CI），一旦检测到语法问题就终止构建，确保文档质量。
• 若需要更精准的规则匹配，可以通过 Asciidoctor Lint 的配置文件自定义检查规则，完全对齐 IntelliJ 的提示逻辑。

内容的提问来源于stack exchange，提问作者Nathan