<kroki type="erd">
  [Person]
  *name
  height
  weight
  +birth_location_id

  [Location]
  *id
  city
  state
  country

  Person *--1 Location 
</kroki>

type 属性告诉kroki使用哪种渲染器，是必需的。

如果代码太大而无法整齐地内联，则可以像这样引用外部文件

<kroki type="plantuml" root="book" path="/assets/my_diagram.plantuml" />

可能的属性包括

• type: 图表类型（必需）
• path: 文件路径（可选）
• root: 路径扩展的位置（可选）。可能的值
  • "system": 您的系统根。需要 src 是绝对路径。
  • "book": 书的根。（包含 book.toml 的目录）
  • "source"：源根目录。（通常是 <书根>/src，但可以在 bool.toml 中配置）
  • "this"：当前 markdown 文件。（省略时为默认值）

在引用文件时，建议使用自闭合标签语法 <kroki/>，但也可以根据需要使用 <kroki></kroki>。如果存在 path 属性，则标签之间的任何内容都将被忽略。

代码块

如果您想使用传统的 markdown 元素，可以将图表源内嵌到您的书中，使用代码块。

```kroki-mermaid
graph TD
  A[ Anyone ] -->|Can help | B( Go to github.com/yuzutech/kroki )
  B --> C{ How to contribute? }
  C --> D[ Reporting bugs ]
  C --> E[ Sharing ideas ]
  C --> F[ Advocating ]
```

代码块的语言必须是 kroki-<图表 类型>。

![]() 图片标签

或者您可以使用 markdown 图片标签引用外部文件

![Excalidraw example](kroki-excalidraw:example.excalidraw)

标题字段可以是任何内容，但源字段需要以 kroki-<图表 类型>: 开始。支持相对路径和绝对路径。相对路径相对于当前 markdown 源文件，不是 mdbook 的根。绝对路径从系统根开始。为了更好地配置路径，请使用 <kroki/> 标签。

端点配置

如果您想使用 Kroki 的自托管实例，可以配置预处理器使用不同的端点

[preprocessor.kroki-preprocessor]
endpoint = "https://127.0.0.1:8000"

如果需要，预处理器会添加尾部斜杠。默认值是 "https://kroki.io/"。

其他

此预处理器仅支持 HTML 渲染。