GemBook 使用 marked 渲染 Markdown，默认支持 CommonMark 和 GitHub Flavored Markdown，GemBook 扩展了 Markdown 语法。
```<语言>? <文件名>? <状态>? <高亮>?
...
```例如使用高亮：
# 代码块信息
```md 1
# 代码块信息
```默认会根据标题文本字段生成 hash，但有时你需要固定 hash，比如国际化时。
### 固定标题锚 Hash {#fixed-hash}> [!NOTE]
> 这是 [高亮引用块](https://github.com/orgs/community/discussions/16925)NOTE
这是 [!NOTE]
TIP
这是 [!TIP]
IMPORTANT
这是 [!IMPORTANT]
WARNING
这是 [!WARNING]
CAUTION
这是 [!CAUTION]
插槽能让你自定义 <gem-book> 的内容，目前支持的插槽有 sidebar-before, main-before, main-after, nav-inside, logo-after。
<!doctype html>
<html>
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
</head>
<body>
<style>
gem-book:not(:defined) * {
display: none;
}
</style>
<gem-book>
<gbp-docsearch
slot="nav-inside"
app-id="05KK61XW6A"
api-key="b6738e2ef6d977e01ab3a325b91937e1"
index-name="book-gemjs"
></gbp-docsearch>
</gem-book>
</body>
</html>
NOTE
使用 --template 指定模板文件才能使用插槽
GemBook 使用自定义元素作为插件系统，他们可以自定义渲染 Markdown 内容或者增强 GemBook 的能力。下面是内置插件 <gbp-raw> 的使用方式：
# 使用内置插件名称
gem-book docs --plugin raw
# 使用本地插件路径
gem-book docs --plugin ./my-plugin.ts
# 使用远端 URL
gem-book docs --plugin https://example.com/plugin.js<script type="module" src="https://unpkg.com/gem-book/plugins/raw.js"></script>然后在 Markdown 中使用它来渲染仓库中的文件：
<gbp-raw src="src/plugins/raw.ts"></gbp-raw>在这里查看所有官方插件。
TIP
在 Markdown 中使用插件时 Attribute 不应该换行，否则会作为内联元素被 <p> 标签打断。
GemBook 内置插件支持自动导入，缺点是渲染文档后才会加载，有可能页面会闪烁。
VSCode 默认不能在 MarkDown 文件中使用 Emmet，你可以通过设置启用：
"emmet.excludeLanguages": [],
"emmet.includeLanguages": {"markdown": "html"},
GemBook 公开一个类 GemBookPluginElement, 他扩展自 GemElement，
包含 许多内部方法和属性。示例：
customElements.whenDefined('gem-book').then(({ GemBookPluginElement }) => {
customElements.define(
'gbp-example',
class extends GemBookPluginElement {
constructor() {
super();
console.log(GemBookPluginElement.config);
}
},
);
}); 