Question

内容参考 (conref) 是便于用来重复使用其他文件和书本内容。

内联引用

有时，在写某一节的内容的时候，会希望读者参见另外一个章节的内容。 可以通过 markdown 的链接语法引导读者到该章节。

例如

回到基础配置，点击 [这里](./basic.md)

回到基础配置，点击 这里

点击 [这里](./https://www.wenjiangs.com/doc/Kj8mhfWm98O77hcx)，回到基础配置

点击 这里，回到基础配置

这两种写法，都能回到首页，但是建议使用 md 文件引用，而不是 html 引用。

gitbook 会自动将 md 引用关联起来，这样无论转换为何种格式，都能使引用生效。

注意

• 回到基础配置，[绝对路径](/config/basic.md)

• 回到基础配置，绝对路径

• 回到基础配置，[相对路径](./basic.md)

• 回到基础配置，相对路径

导入本地文件

使用 include 标签导入其他文件的内容真的很简单：

{% include "./footer.md" %}

从其他书本导入文件

GitBook 同样能处理使用了git协议的include路径：

{% include "git+https://github.com/GitbookIO/documentation.git/README.md" %}

git的url格式是：

git+https://user@hostname/project/blah.git/file#commit-ish

真实的git url应该以 .git 结尾，导入的文件名从 .git 之后的url片段提取。

commit-ish 可以是任何可以作为 git checkout 参数的标签，sha，或分支。默认是 master。

举个例子

我在 footer.md 文档中的内容：

---

Copyright © 2019-2020 码谱

在本页面使用下面的代码引入后：

{% include "./footer.md" %}

显示如下内容：

---

Copyright © 2019-2020 码谱