Markdown和包括多个文件

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

当前回答

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

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

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

2015-02-21 19:38:21

其他回答

就在最近，我在Node中写了一些类似的东西，叫做markdown-include，它允许你用C风格的语法包含markdown文件，像这样:

#include "my-file.md"

我相信这和你问的问题很吻合。我知道这是一个旧的，但我至少想更新它。

您可以将此包含在任何您希望的标记文件中。该文件还可以有更多的include, markdown-include将创建一个内部链接，并为您完成所有工作。

你可以通过npm下载它

npm install -g markdown-include

2015-02-19 21:45:05

我认为我们最好采用一种新的文件包含语法(这样就不会搞砸了代码块，我认为C风格的包含是完全错误的)，我用Perl写了一个小工具，命名为cat.pl，因为它的工作方式像cat (cat a.txt b.txt c.txt将合并三个文件)，但它合并文件的深度，而不是宽度。如何使用?

$ perl cat.pl <your file>

详细语法为:

递归包含文件:@include <-=path= 只包含一个:%include <-=path=

它可以正确地处理文件包含循环(如果a.txt <- b.txt, b.txt <- a.txt，那么您期望什么?)

例子:

a.txt:

a.txt

    a <- b

    @include <-=b.txt=

a.end

b.txt:

b.txt

    b <- a

    @include <-=a.txt=

b.end

Perl cat.pl .txt > c.txt

a.txt

    a <- b

    b.txt

        b <- a

        a.txt

            a <- b

            @include <-=b.txt= (note：won't include, because it will lead to infinite loop.)

        a.end

    b.end

a.end

更多例子请访问https://github.com/district10/cat/blob/master/tutorial_cat.pl_.md。

我还编写了一个Java版本，具有相同的效果(不相同，但接近)。

2016-12-31 14:04:23

恕我直言，你可以通过连接你的输入得到你的结果*。Md文件如下:

$ pandoc -s -o outputDoc.pdf inputDoc1.md inputDoc2.md outputDoc3.md

2018-10-14 17:25:10

另一个使用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

切换到asciidoc，这样你就不必使用Markdown这样的语言了，这些语言现在非常原始:)

2022-06-17 13:23:21

Markdown和包括多个文件

推荐文章

最新文章

标签