markdown - 如何在 Gitbook 中制作样式框（用于注释/警告/...）？

Question

我可以以某种方式<div>在 Gitbook HTML 输出中创建一个在降价中描述的类名吗？我想这样做是为了让信息框与正文分开，这在技术文献中很常见。

我不想在 markdown 本身中嵌入 HTML，因为这首先会蒸发掉使用 markdown 的全部意义。

Sphinx文档创作系统似乎内置了这样的支持。这是一个示例：

.. NOTE:: If you are reading this as HTML, please read `<cheatsheet.txt>`_ instead to see the input syntax examples!

注意：这是我可以使用 Markdown 在段落上定义类名的副本吗？以及如何在 Markdown 中设置 HTML 类属性？

但是，我想我会把它留在这里，因为重点有点高于纯技术。想尝试制作一个 gitbook 插件来提供这个。

Answer 1

您可以尝试使用引号语法并编辑 CSS 以使其看起来更像注释/警告。例如：

笔记：

如果你这样做，坏事可能会发生。

这就是 GitLab 在他们的文档中所做的。