Pandoc을 사용하여 마크다운(markdown)을 EPUB 파일로 변환

Pandoc이란?

Pandoc은 다양한 형식의 문서를 변환할 수 있는 강력한 도구이다. Pandoc을 사용하면, 간편하게 마크다운(markdown) 문서를 이용해서 ePub 파일을 생성할 수 있다.

Pandoc 설치 방법

Windows와 macOS에서 각각 chocolaty와 homebrew를 이용해서 간단히 설치할 수 있다.

macOS 설치 명령

brew install pandoc

Windows 설치 명령

choco install pandoc

Pandoc을 사용한 변환 방법

터미널에서 아래와 같이 Markdown 파일과 생성할 epub 파일명을 지정해서 실행하면 epub 파일이 생성된다.

다음은 명령어의 예시이다.

pandoc note.md -o note.epub

여기서 note.md는 입력할 마크다운 파일의 이름이고, 옵션으로 -o(--output)으로 출력할 EPUB 파일인 note.epub를 지정하였다.

epub 파일을 생성할 때 --css 옵션을 이용하면 epub 생성에 사용할 css 파일을 지정할 수 있다. css 파일을 지정하지 않고 epub 을 생성하면 조금은 못생긴 결과물이 생성되었다. github markdown css 나 기타 커스텀 css 를 이용해서 변환하는 것을 추천한다.

자세한 설치와 이용방법은 pandoc 공식 페이지에 상세하게 소개되어 있다.

유용한 옵션

사용 예

pandoc source.md -o dest.epub -t epub3 --toc --toc-depth=3 --css=mystyle.css --epub-cover-image=mycover.jpg

생성된 ePub 파일

변환된 EPUB 파일을 미리보기 뷰어나 전자책 리더기를 사용하여 확인한다. 레이아웃, 이미지, 링크 등이 올바르게 표시되는지 확인한다.

필요한 경우 EPUB 파일을 수정하고 추가적인 편집을 수행한다. 이는 Calibre와 같은 도구를 사용하여 EPUB 파일을 편집할 수 있다.

참고

• 마크다운을 이용해 epub 만들기
• pandoc 설치 및 사용법