javascript - 将脚本标签添加到 Markdown 文件

Question

关闭。这个问题需要更多focused .它目前不接受答案。












想改善这个问题吗？更新问题，使其仅关注一个问题 editing this post .

2年前关闭。




Improve this question




我正在 MKdocs 中开发文档，需要将一些脚本文件加载到我的 Markdown 文件中。如何在markdown中添加js函数和脚本标签？

Answer 1

您有两个选择:您可以包含原始 HTML <script> Markdown 中的标签，或者您可以使用 MkDocs 的 extra_javascript设置指向您自己的 JavaScript 文件。

使用原始 HTML

作为 Markdown 文档 explains :

For any markup that is not covered by Markdown’s syntax, you simply use HTML itself. There’s no need to preface it or delimit it to indicate that you’re switching from Markdown to HTML; you just use the tags.

The only restrictions are that block-level HTML elements — e.g. <div>, <table>, <pre>, <p>, etc. — must be separated from surrounding content by blank lines, and the start and end tags of the block should not be indented with tabs or spaces.

当然，任何此类脚本对于它们所在的页面都是唯一的。

使用 extra_javascript
如果您希望脚本在您的所有页面上可用，MkDocs 提供了 extra_javascript配置设置，这将导致 script它指向要包含在每个页面上的指定文件。只需确保该文件在您的 docs_dir 中可用。 .

例如，如果您创建一个文件 myscript.js ，然后将以下内容添加到您的 mkdocs.yml配置文件:

extra_javascript:
    myscript.js