Markdown和包括多个文件

是否有任何markdown fork允许你引用其他文件，比如包含文件?具体来说，我想创建一个单独的markdown文件，其中包含我经常调用但不总是调用的链接(调用此B.md)，然后当我通过引用链接到我正在写入的md文件(A.md)时，我希望它从另一个文件(B.md)中拉出链接，而不是从当前文件(A.md)的末尾。

当前回答

您实际上可以使用Markdown预处理器(MarkdownPP)。运行其他答案中的假设图书示例，您将创建.mdpp文件来表示您的章节。然后.mdpp文件可以使用!INCLUDE "路径/to/file。Mdpp指令，该指令在最终输出中用引用文件的内容递归地替换该指令。

chapters/preface.mdpp
chapters/introduction.mdpp
chapters/why_markdown_is_useful.mdpp
chapters/limitations_of_markdown.mdpp
chapters/conclusions.mdpp

然后需要一个索引。MDPP包含以下内容:

!INCLUDE "chapters/preface.mdpp"
!INCLUDE "chapters/introduction.mdpp"
!INCLUDE "chapters/why_markdown_is_useful.mdpp"
!INCLUDE "chapters/limitations_of_markdown.mdpp"
!INCLUDE "chapters/conclusions.mdpp"

要渲染你的书，你只需要在index.mdpp上运行预处理器:

$ markdown-pp.py index.mdpp mybook.md

别忘了看自述书。MarkdownPP存储库中的mdpp，用于展示适合大型文档项目的预处理器特性。

2014-06-03 17:59:12

其他回答

我只想提一下，在将输入文件输送到markdown_py之前，可以使用cat命令连接输入文件，这与pandoc处理多个输入文件的效果相同。

cat *.md | markdown_py > youroutputname.html

在我的Mac上，Python版本的Markdown与上面的pandoc示例几乎相同。

2013-03-16 14:33:34

我使用一个包含我所有文件的正确顺序的include .txt文件我像这样执行pandoc:

Pandoc -s $(cat includes.txt)——quiet -f markdown -t html5——css Pandoc .css -o index.html

效果好极了!

2018-01-31 10:57:52

我在Mac OS x上使用标记2，它支持以下语法来包含其他文件。

<<[chapters/chapter1.md]
<<[chapters/chapter2.md]
<<[chapters/chapter3.md]
<<[chapters/chapter4.md]

遗憾的是，您不能将其提供给pandoc，因为它不理解语法。但是，编写一个脚本来剥离语法来构造一个pandoc命令行是非常容易的。

2015-02-21 19:38:21

另一个使用markdown-it和jQuery的基于html的客户端解决方案。下面是一个小的HTML包装作为主文档，它支持无限的markdown文件的include，但不支持嵌套include。在JS注释中提供了解释。错误处理略。

<script src="/markdown-it.min.js"></script>
<script src="/jquery-3.5.1.min.js"></script>

<script> 
  $(function() {
    var mdit = window.markdownit();
    mdit.options.html=true;
    // Process all div elements of class include.  Follow up with custom callback
    $('div.include').each( function() {
      var inc = $(this);
      // Use contents between div tag as the file to be included from server
      var filename = inc.html();
      // Unable to intercept load() contents.  post-process markdown rendering with callback
      inc.load(filename, function () {
        inc.html( mdit.render(this.innerHTML) );
      });
  });
})
</script>
</head>

<body>
<h1>Master Document </h1>

<h1>Section 1</h1>
<div class="include">sec_1.md</div>
<hr/>
<h1>Section 2</h1>
<div class="include">sec_2.md</div>

2020-06-05 00:39:08

事实上，你可以使用\input{filename}和\include{filename}这两个乳胶命令，因为它支持几乎所有的html和latex语法。

但是要注意，包含的文件将被视为乳胶文件。但是您可以使用Pandox轻松地将您的markdown编译为latex。

2015-11-15 10:21:26

Markdown和包括多个文件

推荐文章

最新文章

标签