pandoc - markdown 을 다양한 포맷으로 변환해 주는 변환기

Haskell 로 만들어진 converter 로 markdown, MediaWiki, textile, HTML, ms 워드(.docx), epub, PDF 등으로 변환이 가능한 유틸리티

설치

수동으로 설치

https://github.com/jgm/pandoc/releases 에 연결후 맨 아래 Downloads에서 사용하는 OS 에 맞는 버전 다운로드

Package manager 로 설치

h4. CentOS

yum install pandoc

Ubuntu

sudo apt install pandoc

OS X

brew install pandoc

Windows

choco install pandoc

scoop install pandoc

PDF 출력

http://pandoc.org/installing.html

pdf로 만들려면 Latex 패키지를 설치해야 하며 권장하는 패키지는 OS 마다 다름

Windows 에서는 https://miktex.org/ 를 OS X 는 http://www.tug.org/mactex/morepackages.html 를 설치하고 필요한 패키지는 tex의 패키지 매니저 사용

주요 옵션

옵션 뒤에 파라미터가 있는 것은 파라미터 필수인 옵션(Ex: -o FILENAME)

옵션	의미	예제
-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 로 사용

사용 예제

cmd 나 쉘에서 pandoc 명령어로 원하는 포맷으로 변환

markdown 변환

http://pandoc.org/getting-started.html

test1.md 파일로 저장

test.md

# Test!

This is a test of *pandoc*.

- list one
- list two

cmd 나 쉘에서 다음 명령어 실행

pandoc test1.md -f markdown -t html -s -o test1.html

-f : from 원본 소스의 포맷(html, json, markdown, docx 등)
-t : to 변환할 포맷(html, json, markdown, docx 등)
-s : standalone
-o : output 출력 파일 이름

test1.md 가 다음 html 로 변환됨

Click here to expand...

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta http-equiv="Content-Style-Type" content="text/css" />
  <meta name="generator" content="pandoc" />
  <title></title>
  <style type="text/css">code{white-space: pre;}</style>
</head>
<body>
<h1 id="test">Test!</h1>
<p>This is a test of <em>pandoc</em>.</p>
<ul>
<li>list one</li>
<li>list two</li>
</ul>
</body>
</html>

markdown 을 MS WORD(docx) 로 변환

pandoc test1.md -f markdown -t docx -s -o test1.docx

Asciidoc 변환

pandoc -o security-basic.asciidoc security-basic.md

Ref

https://github.com/jgm/pandoc/releases