Visual Studio Code 마크다운 변환 플러그인 활용 가이드
개발 및 기술 문서 작성 시 Visual Studio Code 상에서 마크다운 소스를 즉시 다른 형식 파일로 변환해야 하는 경우가 빈번합니다. 대표적으로 Markdown PDF 확장 프로그램을 사용하면 내부 브라우저 엔진을 통해 고품질의 PDF, HTML, PNG, JPEG 파일을 생성할 수 있습니다. 본 가이드에서는 해당 도구의 설치부터 심화 설정까지 효율적인 사용 방법을 다룹니다.
설치 및 기본 요구사항
확장 프로그램을 추가하려면 다음 절차를 따르십시오:
- VS Code 사이드바의 Extensions 메뉴로 이동합니다.
- 검색창에 'Markdown PDF'를 입력하여 공식 확장자를 선택합니다.
- Install 버튼을 클릭하면 의존성인 Chromium 브라우저가 자동으로 다운로드됩니다. 이 과정은 인터넷 연결 환경에서 실행되어야 합니다.
설치가 완료되면 현재 열려 있는 마크다운 파일에서 변환 기능이 활성화됩니다.
파일 내보내기 실행 방식
생성 가능한 포맷은 PDF, HTML, JPEG, PNG 네 가지이며, 작업 상황에 따라 두 가지 방법으로 호출할 수 있습니다.
명령 팔레트 이용
단축키 Ctrl + Shift + P 를 눌러 명령 창을 연 후, 'export' 키워드로 필터링하여 원하는 포맷 옵션을 선택합니다.
마우스 컨텍스트 메뉴
편집 중인 마크다운 에디터 영역에서 마우스 우클릭을 하면 나타나는 메뉴 목록 중 Markdown PDF 관련 항목을 선택하여 즉시 변환을 진행할 수 있습니다.
설정 최적화 및 자동화
settings.json 파일을 수정하면 작업 흐름을 자동화하거나 출력 경로를 제어할 수 있습니다. 다음 예제는 저장 이벤트 발생 시 자동 변환 기능을 켜는 구성입니다.
{
"markdown-pdf.convertOnSave": true,
"markdown-pdf.outputDirectory": "./output",
"markdown-pdf.outputDirectoryRelativePathFile": true
}
위 설정을 적용하면 마크다운 파일이 저장될 때마다 지정된 output 폴더 내에 변환된 결과물이 생성됩니다.
스타일 커스터마이징
기본 렌더링 스타일이 필요하지 않은 경우, 외부 CSS 파일을 참조하여 폰트 크기나 레이아웃을 조정할 수 있습니다.
{
"markdown-pdf.styles": [
"${workspaceFolder}/styles/custom-markdown.css"
],
"markdown-pdf.highlightStyle": "atom-one-dark"
}
여기서 ${workspaceFolder} 변수를 사용하여 프로젝트 루트 경로의 상대적 위치를 지정하면 유지 보수가 용이해집니다. 제공되는 구문 하이라이팅 테마는 50 가지 이상이 지원되며 개발자 선호도에 맞춰 변경 가능합니다.
비주얼 요소 조정 팁
- 이모지 크기 조절: 사용자가 정의한 CSS 파일에 아래 규칙을 추가하여 크기를 변경하세요.
.emoji { height: 24px; width: auto; } - 프록시 환경 설정: 회사 네트워크 등 프록시가 적용된 환경이라면 다음 설정으로 Chromium 다운로드 문제를 해결할 수 있습니다.
"http.proxy": "http://username:password@host:port"
내부 구조 참고사항
필요시 소스 코드 검토를 원한다면 주요 진입 포인트는 extension.js 입니다. 컴파일 로직은 src/compile.js 에 포함되어 있으며, 기본 스타일 리소스는 styles/markdown-pdf.css 에서 관리됩니다. 이를 이해하면 플러그인 작동 방식을 깊이 있게 파악하고 문제 상황을 진단하는 데 도움이 됩니다.