brunch

You can make anything
by writing

C.S.Lewis

by 공인식 Jun 06. 2024

출판을 위한 패키징 1편: PDF

「글을 긷자」 마크다운 문서를 PDF 문서로 변환하는 방법 두 가지

본 화에서는 VS Code 내에서 마크다운 문서를 PDF 문서로 변환하는 방법 두 가지를 소개합니다.


단일 파일 변환

필요한 VS Code 확장

Markdown PDF


VS Code 내 변환하고자 하는 문서가 열린 상태에서 `F1`  또는 `Ctrl + Shift + P` 키 조합을 누릅니다.

그다음 `Markdown PDF: Export (pdf)` 항목을 선택하면, 선택한 문서와 같은 위치에 확장자가 pdf인 동명의 파일이 생성됩니다. `pdf`만 입력해도 선택할 수 있는 명령 중에 사용하고자 하는 것이 확인될 수 있습니다.

VS Code 명령어 입력부에 `Markdown PDF: Export`명령을 입력한 모습
`Markdown PDF: Export (pdf)` 명령 선택 후 PDF 문서 생성 전 임시 HTML 문서가 생성됨
`Markdown PDF: Export (pdf)` 명령으로 최종 PDF 문서가 생성된 후, 해당 파일을 선택했을 때의 모습



여러 파일 변환

필요한 패키지

VitePress ↗

VitePress export PDF

VitePress는 콘텐츠 중심의 빠른 웹사이트를 구축하기 위해 설계된 SSG(정적 사이트 생성기)입니다. 간단히 말해서 VitePress는 Markdown으로 작성된 소스 콘텐츠를 가져와 테마를 적용하고 어디에서나 쉽게 배포할 수 있는 정적 HTML 페이지를 생성합니다. (구글에서 번역됨)
Copyright (c) 2019-present, Yuxi (Evan) You. MIT license.

출처 원문: What is VitePress? ↗


VS Code의 터미널에서 `npm run export-pdf` 명령으로 VitePress 기반의 마크다운 문서 세트를 PDF 문서로 변환할 수 있습니다. OS의 터미널에서 실행할 수 있는 명령으로 처리될 수 있는 작업이라, 꼭 VS Code 내에서 수행될 필요는 없습니다.

VS Code의 터미널에서 `npm run export-pdf` 명령 입력 후 변환이 진행 중인 모습
VitePress 기반의 마크다운 문서 세트가 PDF 문서로 변환된 후, 해당 파일을 클릭했을 때의 모습





연재 안내

브런치북 「글을 Git[긷]자」는 웹 서비스를 위한 UI/UX 개발자인 저자가, 다년간의 실무 경험을 바탕으로 Git과 GitHub 그리고 Visual Studio Code라는 무료 범용 텍스트 에디터를 이용한 글쓰기 방식을 제안하기 위해 기획되었습니다.


https://github.com/enchic/gitzza-plaza

브런치는 최신 브라우저에 최적화 되어있습니다. IE chrome safari