使用 Jade 的 :markdown 过滤器时是否可以包含外部文件？答案

【问题标题】：Is it possible to include external files when using Jade’s :markdown filter?使用 Jade 的 :markdown 过滤器时是否可以包含外部文件？
【发布时间】：2019-07-07 19:44:52
【问题描述】：

我正在构建一个 Express.js 节点应用程序并使用 Jade 模板。 Jade 提供了一个:markdown 过滤器，可以在 Jade 中嵌入 Markdown 代码：

h1 This is Jade
:markdown
  ## And this is Markdown
h3 Back in Jade

（注意：要使用此过滤器，您必须 npm 安装 Markdown 引擎，例如 npm install marked --save。您不必在 Express 应用程序中 require() 此模块，但必须安装它。）

因此，在 Jade 中嵌入 Markdown 可以正常工作。但是，我想将我的 Markdown 保存在单独的文件中，并动态地将它们包含在 Jade 模板中。我已经尝试过了，但它不起作用：

:markdown
  include ../path/to/markdown/file.md

include 命令被视为源代码，而不是被解释为命令。是否可以在:markdown 过滤器中从外部文件中注入 Markdown？

请不要提供解决方法！我知道如何解决这个问题。我想知道:markdown 过滤器是否与外部 Markdown 文件兼容。

【问题讨论】：

标签： javascript node.js express markdown pug

【解决方案1】：

您可以使用 :md 过滤器修饰符包含降价文件。

例如。

html
  body
    include:md ../path/to/markdown/file.md

语言参考：https://pugjs.org/language/includes.html#including-filtered-text

【讨论】：

经过测试并且有效。语言参考中未提及ಠ_ಠ
我将在接下来的几天内更新语言参考以跟上 1.0.0 的发布。欢迎请求请求:)

【解决方案2】：

:md 修饰符对我也不起作用，但这有效：

html
  body

    // works:

    include file.md

    //- does not work:

    include:markdown file.md
    include:md file.md

我正在使用带有 HTML5 Boilerplate 模板的 docpad。

您还应该考虑不自动生成包含*.html.jade 此类包含文件的问题：

How to auto-generate html from jade file when only included markdown file has changed in livereload development environment?

【讨论】：

我正在使用 docpad 6.53.4、docpad-plugin-jade 2.6.2、markdown 0.5.0 和 html5-boilerplate-less-jade-livereload.docpad 0.1.0
在升级到 docpad 6.69.1、docpad-plugin-jade 2.8.0、docpad-plugin-marked 2.2.1 后，include:md 变体有效，include file.md 不再有效

【解决方案3】：

首先，运行这个命令：

npm install marked --save

然后，这样做：

include:md ../path/to/markdown/file.md

【讨论】：