Markdown 并包含多个文件

Question

是否有任何 Markdown 分支允许您引用其他文件，例如包含文件？具体来说，我想创建一个单独的 markdown 文件，其中包含我经常但并不总是调用的链接(称为 B.md)，然后当我在我正在编写的 md 文件(A.md)中通过引用进行链接时，我会喜欢从其他文件 (B.md) 中提取链接，而不是从当前文件 (A.md) 的末尾提取链接。

Answer 1

简短的回答是否定的。长的答案是肯定的。 :-)

Markdown 旨在允许人们编写简单、可读的文本，并且可以轻松转换为简单的 HTML 标记。它并不真正进行文档布局。例如，没有真正的方法可以将图像向右或向左对齐。至于你的问题，在任何版本的 Markdown 中都没有 Markdown 命令可以包含从一个文件到另一个文件的单个链接(据我所知)。

最接近此功能的是 Pandoc 。 Pandoc 允许您在转换过程中合并文件，这样您就可以轻松地将多个文件渲染为单个输出。例如，如果您正在创作一本书，那么您可以有这样的章节:

01_preface.md
02_introduction.md
03_why_markdown_is_useful.md
04_limitations_of_markdown.md
05_conclusions.md

您可以通过在同一目录中执行以下命令来合并它们:

pandoc *.md > markdown_book.html

由于 pandoc 会在翻译之前合并所有文件，因此您可以将链接包含在最后一个文件中，如下所示:

01_preface.md
02_introduction.md
03_why_markdown_is_useful.md
04_limitations_of_markdown.md
05_conclusions.md
06_links.md

因此您的 01_preface.md 的一部分可能如下所示:

I always wanted to write a book with [markdown][mkdnlink].

您的 02_introduction.md 的一部分可能如下所示:

Let's start digging into [the best text-based syntax][mkdnlink] available.

只要您的最后一个文件包含以下行:

[mkdnlink]: http://daringfireball.net/projects/markdown

...之前使用的相同命令将执行合并和转换，同时包含该链接。只需确保在该文件的开头留下一两行空白即可。 pandoc documentation说它在以这种方式合并的文件之间添加了一个空行，但是如果没有空行，这对我来说不起作用。