옵시디언 마크다운을 MS Word, Power Point로 변환 - Pandoc
옵시디언을 사용하여 잘 정리된 기사가 있으면 가끔 동료나 친구와 공유해야 할 수도 있습니다. 옵시디언 자체는 PDF 파일로 내보내는 기능을 제공하지만 수정이 가능한 Word(docx)나 Power Point(pptx) 파일 형태로 공유하고 싶다면 새로운 파일을 많이 복사해서 붙여넣는 것은 혼전.
그래서 이 작업을 더 쉽게 만들어줄 옵시디언 커뮤니티 플러그인 Pandoc을 소개하려고 합니다.
Pandoc이란 무엇인가요?
Pandoc은 하나의 마크업 형식을 PDF, MS Word, PowerPoint는 물론 Markdown, HTML, LaTeX로 변환하는 라이브러리입니다. 기본적으로 윈도우 Powershell이나 Linux 터미널에서 명령어로 사용할 수 있는 CLI 도구입니다.
하지만 명령어를 이용한 문서 변환은 복잡하기 때문에 Pandoc을 GUI 환경에서 쉽게 사용할 수 있도록 플러그인 형태로 제공됩니다. 옵시디언의 커뮤니티 플러그인 메뉴에서 검색하면 두 개의 플러그인이 나옵니다. 이번 글에서는 첫 번째 Pandoc 플러그인에 대해 이야기해보겠습니다. 실제로 두 번째로 검색한 옵시디언 Enhancing Import를 사용해 보았는데 잘 되지 않았습니다.
옵시디언 - 커뮤니티 플러그인 - Pandoc 플러그인
Pandoc 설치
Pandoc 플러그인은 자체적으로 작동하지 않습니다. 플러그인은 공식 Pandoc 라이브러리를 사용하여 문서를 변환합니다.
따라서 Pandoc 공식 사이트를 방문하여 Pandoc 라이브러리를 다운로드하여 설치해야 합니다.
Pandoc 사이트를 방문해보세요. Pandoc은 윈도우, macOS, Linux 등 다양한 유형의 OS 설치 패키지를 지원합니다. 다운로드하여 설치하세요.
Pandoc 공식 사이트 - 다운로드
윈도우 사용자라면 msi 형식의 설치 패키지를 권장합니다. zip 형식의 휴대용 버전을 사용하려는 경우에는 큰 문제가 되지 않습니다. 아무튼, 적당한 위치에 다운받아 설치하거나 압축을 풀어주세요.
옵시디언에서 Pandoc 플러그인 설치 및 구성
옵시디언 설정에서 커뮤니티 플러그인 사용을 허용하고, 커뮤니티 플러그인 메뉴에서 Pandoc 플러그인을 검색하여 설치하세요. 그리고 활성화하세요.
옵시디언 - 설정 - 커뮤니티 플러그인 - Pandoc 플러그인
플러그인이 설치되고 활성화되면 다음 단계는 플러그인을 설정하는 것입니다. 설정에 Pandoc Plugin 항목이 추가된 것을 확인할 수 있습니다. 여기서 설정해야 할 부분은 내보내기 폴더와 Pandoc 경로입니다.
옵시디언 - 설정 - 커뮤니티 플러그인 - Pandoc 플러그인 설정
내보내기 폴더: 옵시디언 Markdown을 원하는 파일 형식으로 변환할 때 파일이 저장되는 폴더입니다.Pandoc 경로: 위에서 다운로드하여 설치한 Pandoc 라이브러리의 실행 파일 경로입니다.- 윈도우 msi 또는 Linux deb를 사용하여 Pandoc을 설치한 경우에는 구성할 필요가 없습니다. Pandoc 라이브러리를 설치하면 실행파일 경로가 환경변수에 등록되므로 옵시디언은 Pandoc 경로를 자동으로 인식합니다.
- 단, 이식 가능한 형식의 zip 파일을 다운로드하여 압축을 해제한 경우
pandoc.exe에 전체 절대 경로를 추가하거나pandoc의 실행 파일 경로를 추가해야 합니다. 윈도우 환경에 있다고 가정하면 적절한 예는C:\Data\pandoc-3.1.11.1-windows-x86_64\pandoc-3.1.11.1\pandoc.exe입니다.
모든 작업이 완료되면 옵시디언을 다시 시작하세요.
Pandoc 플러그인 사용법
옵시디언 Markdown을 원하는 파일 형식으로 변환하려면 Ctrl + P를 눌러 빠른 팔레트를 엽니다. 그런 다음 pandoc 플러그인을 검색하여 원하는 파일 형식을 선택하면 위에서 설정한 내보내기 폴더에 파일이 생성됩니다.
옵시디언 - 기사 - Ctrl + P - pandoc 플러그인 검색 - 변환하려는 형식 선택
게시물에 이미지가 없으면 문제가 없으나, 이미지가 포함되어 있으면 이미지 파일을 찾을 수 없다는 오류가 뜹니다
옵시디언 - Pandoc 플러그인 - 이미지 파일을 첨부하여 게시 - Word 문서로 내보내기(docx)
Pandoc의 파일 변환 오류 해결 방법
문제의 원인은 플러그인이 마크다운 파일의 위치를 기준으로 게시물에 첨부된 이미지 파일을 찾지 못하는 것입니다. 플러그인은 옵시디언 보관소 루트에서 이미지 파일을 찾으려고 시도합니다. 그래서 이미지 파일이 없다고 에러가 뜹니다.
이 문제를 해결하기 위해 플러그인 설정의 Extra Pandoc 인수에서 --resource-path 옵션을 설정해 보았지만 작동하지 않았습니다. 불행하게도 이 버그는 수정할 수 없습니다. 플러그인이 업데이트되지 않았고 더 이상 1년 넘게 유지 관리되지 않기 때문입니다. 그러나 우회 방법이 존재합니다!
해결책은 내보내기 목적으로만 새 볼트를 생성하고 문서 형식 변환이 필요할 때 사용하는 것입니다. md 및 이미지 파일을 볼트 루트에 복사하고 변환합니다.
수출 전용의 새로운 옵시디언 금고
물론, 파일을 변환할 때마다 내보내기 목적으로 md 파일과 이미지 파일을 볼트에 복사하는 것은 번거롭지만, 변환된 파일의 품질을 고려하면 그만한 가치가 있는 번거로움이 있을 수 있습니다. 아래는 Pandoc을 이용하여 md를 word(docx)로 변환한 결과입니다.
Pandoc에서 만든 Word 파일
아래는 Pandoc을 이용하여 md를 파워포인트(pptx)로 변환한 결과입니다.
Pandoc에서 만든 PowerPoint 파일