Pandoc으로 Markdown Github-style 렌더링하기

|

Pandoc이라는 Haskell로 작성 된 convertermarkdown, mediawiki, textile, HTML, docx(ms word), epub, PDF 등으로 변화이 가능한 유틸리입니다.

# 설치

다운로드에서 스크롤을 내리시면 OS별로 설치 파일을 받을 수 있습니다. OS 버전에 맞는 걸로 설치 해주세요.

# 주요 옵션

옵션 설명
-o FILENAME, –output=FILENAME 저장할 파일명
-f FORMAT, –from=FORMAT 소스 포맷
-t FORMAT,–to=FORMAT 저장할 포맷
–toc 목차 생성
-S, –smart pandoc 이 소스 포맷을 판단해서 처리
-s, –standalone 파일이 아닌 STDIN 에서 입력 수행
-c URL, –css=URL 변환시 사용할 CSS 의 URL
-H FILENAME, –include-in-header=FILENAME FILENAME 을 HEADER 로 사용
-A FILENAME, –include-after-body=FILENAME FILENAME 을 footer 로 사용

-o FILENAME은 필수 옵션입니다.

Github Style로 변환하기

GitHub Sytle에 들어가셔서 CSS파일을 다운로드 받아주세요. 이 포스팅의 가장 핵심인 파일입니다. 여기서 받은 파일을 --css 옵션으로 줘서 Github-Style로 만들수 있습니다.

pandoc test1.md -f markdown -t html -s --css=github-pandoc.css -o test1.html

위와 같이 Markdown파일이 있는 위치에 css파일도 두고 변환을 시켜주시면 됩니다. PDF로 바로 저장도 되지만 LaTeX 패키지가 필요해서 LaTeX유저가 아니시면 HTML로 변환 하시고 PDF 인쇄 옵션을 통해서 저장하셔도 괜찮습니다.

주의 하실 점은 CSSHTML을 꾸며서 만드는 것이기 떄문에 CSS파일의 위치 참조가 깨지면 다시 평문 형태로 돌아가기 때문에 추출한 파일을 이동하실 때에는 CSS파일과 같이 움직여 주세요.

Comments