Markdown을 Word 템플릿을 채우면서 docker pandoc에서 Word로 변환

설계서를 Markdown으로 하고 Git로 관리할 수 없는가 하는 이야기가 나왔으므로,
환경 구축 및 Markdown 파일에 템플릿을 채울 때까지 실시해 본다.

확인 환경

Mac OS Mojave 10.14.3

전제

도커이 설치되어 있어야 합니다.

절차

샘플용 Markdown 파일을 가져옵니다.

$ curl https://raw.githubusercontent.com/mitsuaki1229/Sample/master/Documents/ForPandockConversionFile/ForPandockConversionFile.md -o ForPandockConversionFile.md

변환 할 때 레이아웃으로 채우는 무료 템플릿을 빌리고 해동.

$ curl http://siland.jp/data/manual.zip -o manual.zip
$ docker run --rm -v `pwd`:/data ca54makske/ubuntu-unzip -Ocp932 ./manual.zip

빌린 템플릿을 채우면서 Markdown 파일에서 Word 파일을 생성.

$ docker run -v `pwd`:/source jagregory/pandoc -f markdown -t docx README.md -o README.docx --reference-doc='業務マニュアル（テンプレート）/グリーン.docx'

결과

$ open README.docx

이전에 있던 직장에서 설계서나 매뉴얼을 Markdown에서 pandoc을 이용하여 Word나 PDF로 변환하고 있을 때는,
로컬 PC에 환경을 구축하는 것이 힘들었던 기억이 있지만, docker라고 곧 할 수 있어 편하다.
Word의 템플릿 레이아웃과 Markdown 태그를 잘 뇌내 매핑하면 좋은 느낌으로 할 수 있을 것 같지만,
좋은 느낌의 변환 결과를 원한다면 Word 레이아웃을 만드는 지식이 어느 정도 필요합니다.

참고

시광 D. JP

Mac에서 Windows로 만든 일본어 파일 이름 혼합 zip 파일을 압축 해제하고 싶습니다.

Pandoc User’s Guide

Extended Syntax