Markdown을 PDF로 변환

여기서 "Markdown을 PDF로 변환"의 의미

Markdown은 대부분의 개발자와 기술 작성자가 실제로 글을 쓰는 형식입니다 — README 파일, 블로그 초안, 런북, API 문서, 내부 위키. 가볍고, 버전 관리가 되며, GitHub에서 깔끔하게 렌더링됩니다. 하지만 그 문서를 저장소에서 일하지 않는 사람과 공유할 때가 오면, PDF가 보통 올바른 전달 형식입니다: 예측 가능하게 인쇄되고, 어떤 기기에서도 열리며, 수신자가 마크다운 뷰어를 설치했는지에 의존하지 않습니다.

imisspdf의 Markdown을 PDF로 도구는 여러분이 붙여넣은(또는 .md 파일로 끌어다 놓은) 마크다운 원본을 받아 브라우저 안에서 하나의 PDF를 만듭니다. 제목은 계층 구조를 유지하고, 목록은 들여쓰기를 유지하며, 펜스 코드 블록은 고정폭 글꼴로 렌더링되고, 인용문 / 가로선은 인용문과 선처럼 보입니다. 결과는 README, 기술 보고서, 비기술 독자에게 전달하는 변경 기록에 적합한 깔끔하고 군더더기 없는 PDF입니다.

변환이 작동하는 원리

세 단계가 여러분의 탭에서 처음부터 끝까지 실행됩니다:

1. marked 파서가 GFM 규칙(펜스 코드, 취소선, 작업 목록, 자동 링크)을 켠 채 마크다운을 HTML로 변환합니다.
2. 작은 정규식 기반 토크나이저가 HTML을 훑어 블록 토큰의 평탄한 시퀀스 — 제목, 단락, 목록, 코드 블록, 인용문 — 와 인라인 구간(굵게, 기울임, 인라인 코드, 링크)으로 변환합니다.
3. pdf-lib이 14개의 표준 PDF 글꼴(본문에 Helvetica, 코드에 Courier)을 써서 블록을 페이지에 배치합니다. 내용이 넘치면 새 페이지가 추가됩니다.

이 과정의 어떤 것도 서버와 통신하지 않습니다. 원격으로 렌더링되는 마크다운도, 클라우드 함수에서 시동되는 헤드리스 Chromium도, "보관 준수를 위해 한 시간 동안" 보관되는 임시 파일도 없습니다. PDF는 개발자 도구에서 쓰이는 것을 지켜볼 수 있는 자바스크립트 바이트로 만들어집니다.

이 도구가 적합할 때 — 그리고 그렇지 않을 때

이 도구는 기술 내용의 깔끔하고 보관 가능한 PDF가 필요할 때 적합합니다: README, 런북, 마크다운으로 쓴 보고서, 회의 메모, 튜토리얼. 그런 종류의 문서에 기대할 만한 대로 인라인 서식, 목록, 코드, 인용문을 처리합니다.

렌더링된 사이트와의 픽셀 단위 충실도가 필요할 때(렌더링된 페이지에서 브라우저의 PDF로 저장 옵션을 쓰세요), 조판 수준의 표가 필요할 때 (로컬에서 Pandoc + LaTeX를 쓰세요), 구문 강조된 코드가 필요할 때 (편집기에서 HTML로 내보내 HTML을 PDF로 쓰세요)에는 적합하지 않습니다. 올바른 작업 흐름을 고를 수 있도록 한계를 미리 밝힙니다.

프라이버시와 보안

마크다운은 서버에 두고 싶지 않은 것들을 담을 가능성이 가장 높은 형식 중 하나입니다: 코드 블록 안의 API 키, 링크 안의 내부 URL, 아직 공개하지 않은 게시물 초안, 회의 메모 안의 고객 이름. 서버 기반 마크다운-PDF 도구는 그 모든 것을 받아들여야 합니다. 이 도구의 아키텍처는 프라이버시 정책을 믿을 필요가 없다는 뜻입니다 — 과정에 업로드 단계가 아예 없습니다. 네트워크를 차단해도 페이지가 로드된 후에는 변환이 계속 작동합니다.

좋은 출력을 얻기 위한 팁

• 진짜 제목을 쓰세요. 줄 시작의 #은 h1이 되고, 하위 수준은 깔끔하게 중첩됩니다. PDF 리더와 스크린 리더가 개요를 인식합니다.
• 펜스 코드 블록을 유지하세요. 삼중 백틱 블록은 Courier로 렌더링되어, 줄바꿈이 일어나도 들여쓰기가 올바르게 읽힙니다.
• 이미지가 많은 마크다운은 피하세요. 외부 이미지는 내려받지 않습니다. 이미지는 따로 PDF로 변환한 뒤 합치세요.
• 표는 먼저 도구에서 마크다운을 렌더링한 뒤 스크린샷을 찍으세요. 또는 조판 수준의 표를 위해 로컬에서 Pandoc을 쓰세요.

관련 PDF 도구

• HTML을 PDF로 — 같은 렌더러로, 마크다운 대신 HTML 입력.
• TXT를 PDF로 — 서식이 전혀 없는 일반 텍스트.
• PDF 병합 — 마크다운 PDF를 이미지나 다른 파일과 합칩니다.
• PDF 압축 — 공유를 위해 출력을 줄입니다.