Gitbook标题添加ID和内部链接

Question

我是编程社区的新手，也是Gitbook的新手。我搜索过gitbook doc但仍然有一些语法问题。

我一直在尝试添加内部链接，以便在长长的网页上，我可以点击页面顶部的链接，它会将我引导到页面底部包含的内容块。我也有一些长页面。

[Clickable Link1](redirects to headerId1 in the same page)
[Clickable Link2](redirects to headerId2 in the same page)
...

Real Content
Header 1 with id = headerId1
Content1

Header 2 with id = headerId2
Content2
...

我寻找的资源包括： https://gitbookio.gitbooks.io/markdown/content/syntax/links.html

我遇到的问题是：

1. 为标题添加ID。

   我尝试输入### Header1 {#id=myheader1}在输入###后跟一个空格后，Header1 {#id=myheader1}变得很大并显示为heading3大小的文本。如何逃避并确保它只显示带有标题1字体的Header 1并且标识为标题为header1？

2. 请参阅内部标题 我试图按照文档进行操作，但仍然只显示带有[]的原始文本，而不会变成可点击的链接。

请分享一些提示和帮助。非常感谢你。

Answer 1

我强烈建议不要手动构建目录。制造它们是一种痛苦，维持它们更是痛苦。

相反，让软件为您解决这个问题。这是我刚发现的两个GitBook插件，用于制作目录：

• https://www.npmjs.com/package/gitbook-plugin-page-toc
• https://www.npmjs.com/package/gitbook-plugin-simple-page-toc

插件can be enabled within the editor or by editing the book.json file.