Уценка и включение нескольких файлов

Есть ли какая-либо вилка уценки, которая позволяет вам ссылаться на другие файлы, что-то вроде включаемого файла? В частности, я хочу создать отдельный файл уценки со ссылками, которые я вызываю часто, но не всегда (назовем это B.md), затем, когда я ссылаюсь по ссылке в файле md, который я пишу (A.md), я бы нравится извлекать ссылку из другого файла (B.md), а не из конца текущего файла (A.md).

Решение проблемы

Краткий ответ: нет. Длинный ответ - да.:-)

Markdown был разработан, чтобы позволить людям писать простой, читаемый текст, который можно было бы легко преобразовать в простую разметку HTML. На самом деле это не макет документа. Например, нет реального способа выровнять изображение по правому или левому краю. Что касается вашего вопроса, то нет команды уценки для включения одной ссылки из одного файла в другой в любой версии уценки (насколько я знаю).

Ближе всего к этой функциональности можно подойти 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 сказано, что она добавляет пустую строку между объединенными таким образом файлами, но у меня это не сработало без пустой строки.