Markdown Include 결합기

Markdown Include 결합기 사용 가이드

책이나 매뉴얼을 장마다 따로 쓰고 마지막에 한 파일로 묶어야 할 때, 본문에 '<!-- include: chapters/intro.md -->' 같은 표시만 해 두면 이 결합기가 그 자리에 해당 파일 내용을 끼워 넣어 줍니다.

본문과 포함할 파일을 함께 선택하면, include 주석이 있는 파일을 본문으로 보고 경로가 같은 파일을 찾습니다. 브라우저는 폴더 이름을 알려 주지 않으므로 'chapters/intro.md'는 파일 이름 intro.md로도 찾아 줍니다. 끼워 넣은 파일 안의 include도 차례로 풀고, 자기 자신을 다시 부르는 순환은 건너뜁니다.

끼운 부분은 '<!-- begin 경로 -->', '<!-- end 경로 -->'로 감싸 표시하고, 찾지 못한 파일은 '<!-- 찾지 못한 include: 경로 -->'로 남깁니다.

사용 방법

1. 1'Markdown 파일 (본문과 포함할 파일 모두)'에서 본문 파일과 끼워 넣을 장 파일을 함께 고릅니다.
2. 2본문을 파일로 고르지 않았다면 '본문 붙여넣기 (선택)' 칸에 include 주석이 든 본문을 붙여 넣습니다.
3. 3'실행'을 누르고 '찾지 못한 include' 표시가 없는지 확인한 뒤 '다운로드'합니다.

선택한 파일:
book.md → # 책 / <!-- include: chapters/intro.md --> / <!-- include: missing.md -->
intro.md → ## 소개 / <!-- include: detail.md -->
detail.md → 세부 내용

# 책
<!-- begin chapters/intro.md -->
## 소개
<!-- begin detail.md -->
세부 내용
<!-- end detail.md -->
<!-- end chapters/intro.md -->
<!-- 찾지 못한 include: missing.md -->

이럴 때 쓰면 좋아요

• 장별로 나눠 쓴 원고를 한 권의 Markdown으로 묶을 때
• 여러 문서에 들어가는 공통 안내문을 한 파일로 관리할 때
• EPUB이나 PDF로 만들기 전에 전체 원고를 합칠 때
• 문서 사이트 빌드 전에 include가 제대로 풀리는지 확인할 때

문제가 생겼을 때

활용 팁

• begin·end 표시 주석은 화면에 보이지 않으므로 그대로 둬도 됩니다. 나중에 어느 파일에서 온 내용인지 찾을 때 도움이 됩니다.
• 합친 뒤 Markdown 제목 계층 검사기로 장 파일들의 제목 단계가 본문과 잘 이어지는지 확인하세요.

자주 묻는 질문