如何在Asciidoc中引用PlantUML时显示其标题而非ID？

• 方法一：为PlantUML代码块添加title属性并绑定锚点
  Asciidoc的代码块锚点不会自动关联PlantUML内部的标题，你可以直接在代码块定义时指定title属性，同时绑定锚点，这样交叉引用就会显示设定的标题：

  [[sch_id]]
  [plantuml, title="My great title"]
  ----
  @startuml
  ' 你的PlantUML图形代码
  @enduml
  ----
  

  之后使用<<sch_id>>引用时，就会显示为“My great title”而非锚点ID。

• 方法二：显式指定引用的显示文本
  若不想修改代码块定义，也可以在交叉引用时手动指定要显示的内容：

  <<sch_id, My great title>>
  

  这种方式灵活性强，适合需要自定义引用显示文本的场景。

• 注意事项：确保你的Asciidoc处理器（如Asciidoctor）支持PlantUML集成的标题关联，旧版本可能需要升级处理器或启用相关扩展。

内容的提问来源于stack exchange，提问作者A.Pissicat