살아가는 이야기
pandoc 설치 및 사용법 ― 이번 주말은 pandoc과 함께 본문
한 번 쓴 글을 HTML로 만들어 웹에도 게시하고 docx로 만들어 책으로 쓰기도 하고 pdf로 만들어 친구에게 전송할 수 있다면 얼마나 좋을까? 이런 원대한 꿈에서 탄생한 프로그램이 있었으니 바로 pandoc이다. pandoc의 pan-은 '전체를 아우른다'는 뜻이 있으므로, pandoc 모든 문서(doc)를 다 아우른다는 뜻으로 명명한 것이 아닌가 싶다.
pandoc은 아래 사이트에서 다운로드하여 설치할 수도 있지만
https://pandoc.org/installing.html
개인적으로는 choco(Chocolatey)를 이용하여 설치하는 것을 추천한다. choco는 Windows의 설치 관리자인데 ― 데비안의 apt나, 레드햇의 yum, 아치리눅스의 pacman과 유사함 ― choco 설치 방법은 이전 글(https://woogyun.tistory.com/720)을 참고하기 바란다.
1. 관리자용 PowerShell 실행
choco를 이용하여 설치하려면 Windows PowerShell을 관리자 모드로 실행해야 한다. 검색에서 PowerShell을 찾은 후 "관리자로 실행"을 클릭한다.
사용자 계정 컨트롤 메시지가 뜨면 ― 간혹 작업 표시줄에 방패 아이콘만 깜빡이는 경우가 있는데, 그럴 땐 방패 아이콘을 누르면 됨 ― 가볍게 "예"를 클릭해 준다.
2. choco를 이용한 pandoc 설치
관리자로 실행된 후에는 choco 명령어로 pandoc을 설치한다.
PS> choco install pandoc
설치가 완료되면 다음과 같이 refreshenv를 실행하여 환경 변수의 변경을 반영해야 한다는 메시지가 나온다.
PS> refreshenv
그러나 pandoc의 경우에는 이미 추가된 PATH 내에 있으므로 굳이 refreshenv를 실행하지 않아도 된다.
3. pandoc을 이용한 HTML 생성 테스트
관리자 창에서 "explorer ."을 입력하여 현재 폴더를 탐색기로 연 다음, 폴더 바탕에서 우클릭하여 "새로 만들기(W)->텍스트 문서" 메뉴를 선택하여 텍스트 문서를 만든다. 문서 이름을 "test1.md"로 변경한 후 이를 메모장으로 연다(test1.md파일 아이콘을 더블클릭할 때 메모장을 선택함). 이 부분이 번거롭다면 저장할 때 이름을 변경하기로 하고, 이름 변경 없이 메모장을 연다. 그리고 다음 내용을 입력한다.
# Pandoc 테스트 파일
이 파일은 *pandoc*을 테스트하기 위한 파일입니다.
- 첫 번째 목록
- 두 번째 목록
입력이 끝나면 "파일→다른 이름으로 저장" 메뉴를 이용하여 "test1.md"로 저장한다. 이때 대화창에서 파일 형식을 (1) "모든 파일 (*.*)"로 선택해야 파일 확장자를 .md로 바꾸어 저장할 수 있는데, 저장 시 (2) 파일 인코딩은 "UTF-8"으로 선택하여 저장해야 한다.
이렇게 저장이 끝나면 다음 명령어로 HTML 파일 test.html을 생성할 수 있다.
PS> pandoc test1.md -f markdown -t html -s -o test1.html
생성된 HTML을 웹브라우저에서 확인하면 다음과 같다.
4. pandoc을 이용한 docx 생성 테스트
앞서 언급한 대로 파일을 생성한 후에는 다음 명령어로 docx를 생성할 수 있다.
PS> pandoc test1.md -f markdown -t docx -s -o test1.docx
생성된 docx 파일을 열어 보면 다음과 같다.
5. pandoc을 이용한 pdf 파일 생성 테스트
pdf 파일을 생성하려면 LaTeX이 설치되어 있어야 한다(LaTeX 설치는 이전 글 https://woogyun.tistory.com/663을 참고). LaTeX이 설치되어 있다면 pandoc에서 XeLaTeX을 부르는 방식으로 pdf 파일을 생성할 수 있는데, 구체적으로 다음 명령어를 입력하면 된다.
PS> pandoc test1.md -f markdown -t pdf --pdf-engine=xelatex -V CJKmainfont="바탕" -o test1.pdf
pdf를 생성할 때는 한글 글꼴을 선택할 수 있는데, 여기서는 "바탕"을 선택하였다. pdf 파일 생성 결과는 다음과 같다.
축하한다. pandoc 설치와 테스트가 완료되었다.
이렇게 설치가 완료된 후에는 pandoc을 이용하여 자신만의 라면 조리법을 하나 적어 보자. 의외로 재미있다.
