[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 설명서 는이 방법을 병합 파일 사이에 빈 줄을 추가 있다고하지만, 이것은 빈 줄없이 나를 위해 일을하지 않았다.

답변

cat *.md | markdown_py > youroutputname.html

chapters/preface.mdpp
chapters/introduction.mdpp
chapters/why_markdown_is_useful.mdpp
chapters/limitations_of_markdown.mdpp
chapters/conclusions.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"

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

changequote(`{{', `}}')
include({{other_file}})

m4 -I./dir_containing_other_file/ input.md > _tmp.md
pandoc -o output.html _tmp.md

#include "my-file.md"

npm install -g markdown-include

{{some_other_file.txt}}