마크다운(MD)을 PDF로 변환

마크다운 PDF 변환 사용 방법

1. .md 파일 열기마크다운 파일을 고르거나 도구 위로 끌어다 놓으세요. 메모 앱, 위키, 코드 저장소에서 내보낸 파일도 표준 마크다운 문법을 쓴다면 모두 됩니다.
2. 용지와 기본 글자 크기 정하기‘용지 크기’에서 A4나 레터를 고르고, 본문의 기본 ‘글자 크기’를 정하세요. 크기를 작게 할수록 넓은 표나 긴 코드 줄이 페이지 폭 안에 더 많이 들어갑니다.
3. 렌더링하고 다운로드하기‘PDF 만들기’를 누르고 저장하세요. 다른 사람에게 보내기 전에 한 번 열어 제목, 표, 이미지 자리 표시를 확인하세요.

예시로 살펴보기

프로젝트의 README.md에는 문서 제목 하나, 섹션 두 개, 번호가 매겨진 설치 단계 목록, 셸 코드 블록 하나, 3열짜리 표가 있습니다. A4와 기본 글자 크기 11 pt로 변환하면 문서 제목(#)은 22 pt(11 × 2), 섹션 제목(##)은 17.6 pt(11 × 1.6), 코드 블록은 음영 띠 위에 Courier 9.68 pt(11 × 0.88), 표 안의 글자는 10.12 pt(11 × 0.92)로 배치됩니다.

본문 폭 171.9 mm(210 mm에서 19.05 mm 여백 두 개를 뺀 값)를 똑같이 나누므로, 표의 세 열은 각각 약 57.3 mm를 차지합니다. 결과는 README.pdf로 다운로드됩니다.

할 수 있는 일과 한계

• 참조한 파일을 불러오지 않으므로 이미지는 [image: 대체 텍스트] 형태의 자리 표시로 나타납니다.
• http, https, mailto 링크만 클릭할 수 있고, 상대 경로 링크는 링크 모양의 글자로만 표시됩니다.
• 각주, 수식, 다이어그램 코드는 그 형태 그대로 렌더링되지 않습니다.
• 스타일은 고정되어 있어 테마나 사용자 CSS를 쓸 수 없습니다.
• 아랍어처럼 오른쪽에서 왼쪽으로 쓰는 문자와 힌디어, 태국어 같은 복잡한 문자는 올바르게 배치되지 않습니다.

마크다운 PDF 변환 소개

마크다운은 쓰기에는 편하지만, 개발자가 아닌 독자는 샵과 별표투성이인 파일보다 제대로 된 문서를 받고 싶어 합니다. 이 도구는 MIT 라이선스의 오픈 소스 라이브러리인 marked로 마크다운을 해석합니다. 기준은 CommonMark 사양에 GitHub이 추가한 두 가지, 곧 표와 취소선을 더한 것입니다. 해석한 문서는 읽기 쉬운 단일 스타일로 A4나 레터 페이지에 조판됩니다.

서식이 적용되는 요소

• 제목, 문단, 굵게, 기울임꼴, 취소선
• 인라인 코드, 그리고 음영 배경 위에 고정폭 글꼴로 표시되는 펜스 코드 블록
• 글머리 기호 목록, 번호 목록, 중첩 목록
• 인용문과 가로 구분선
• 단순한 격자로 그리는 표
• PDF 안에서도 클릭할 수 있는 링크

모양은 고정되어 있습니다. 테마가 없고 직접 만든 CSS를 적용할 방법도 없습니다. 정할 수 있는 것은 용지 크기와 기본 글자 크기 두 가지뿐입니다. 덕분에 도구를 빠르게 쓸 수 있고 결과물이 일정하게 나오므로, 디자인에 공들인 브로슈어보다는 배포 자료, 문서, 보고서에 잘 맞습니다.

이럴 때 사용합니다

• 저장소 밖의 사람에게 보낼 README

  마크다운으로 쓴 프로젝트 설정 안내를 어디서나 열리는 PDF로 만들어 고객이나 관리자에게 보낼 수 있습니다. 설치 단계는 번호 목록으로, 명령어는 음영이 깔린 코드 블록으로 나타납니다.

• 회의 메모를 배포 자료로

  안건마다 제목을 달고, 결정 사항은 글머리 기호로, 담당자와 날짜는 작은 표로 빠르게 적은 마크다운 메모가 다음 회의에서 나눠 줄 인쇄용 페이지가 됩니다.

• 텍스트 편집기로 쓴 과제

  수업 포털은 PDF만 받는데 과제는 마크다운으로 씁니다. 최종 파일을 변환하면 제목, 인용문, 출처 링크의 서식이 살아 있는 문서를 올릴 수 있습니다.

그림이 자리 표시로 나타나는 이유

마크다운은 ![사이트 맵](images/map.png)처럼 경로나 웹 주소로 이미지를 가리킵니다. 이 페이지는 사이트 밖의 파일을 불러오지 않으므로 참조한 이미지를 가져오지 않습니다. 그 자리에 PDF는 대괄호 안의 설명을 넣은 [image: 대체 텍스트] 형태의 자리 표시를 보여 주므로, 독자는 그곳에 그림이 있었다는 것을 알 수 있습니다. 그러니 마크다운에 의미 있는 대체 텍스트를 써 두면 도움이 됩니다.

그림이 중요하다면 JPG PDF 변환이나 PNG PDF 변환으로 그림만 따로 PDF로 만든 뒤, PDF 합치기로 렌더링한 텍스트와 합치세요.

언어와 사용하는 글꼴

영어를 비롯해 라틴 문자로 쓰는 언어에는 모든 PDF 뷰어에 이미 들어 있는 표준 글꼴인 Helvetica와 Courier를 쓰므로 글꼴을 포함할 필요가 없습니다. 그리스 문자와 키릴 문자는 Roboto, 중국어와 일본어는 Droid Sans Fallback(둘 다 Apache-2.0), 한국어는 나눔고딕(Nanum Gothic, SIL Open Font License)으로 배치하며, 각각 문서에 쓰인 글자만 담은 서브셋으로 포함됩니다. 중국어·일본어 글꼴은 약 4 MB, 한국어 글꼴은 약 2 MB를 내려받아야 하는데, 브라우저는 마크다운에 실제로 그런 글자가 있을 때만 각 글꼴을 받아 옵니다.

한국어는 일반적인 한국어 조판처럼 어절 단위로 줄이 바뀝니다. 아랍어, 히브리어 등 오른쪽에서 왼쪽으로 쓰는 문자와 힌디어, 태국어 같은 복잡한 문자는 올바르게 배치되지 않습니다. 이런 언어로 된 문서는 해당 언어를 지원하는 워드프로세서나 브라우저에서 PDF로 만드는 편이 낫습니다.

결과물의 품질과 용량

PDF의 모든 글자는 벡터 텍스트라서 아무리 확대해도 선명하고, 검색하고 복사할 수 있습니다. 그림을 넣지 않고 글꼴도 서브셋으로만 담기 때문에, 일반적인 마크다운 문서는 이메일로 보내기 쉬운 가벼운 파일이 됩니다. 링크는 링크를 지원하는 뷰어에서 계속 작동합니다. 인쇄본에 페이지 번호가 필요하면 결과물을 PDF 페이지 번호 넣기에 넣으세요.

렌더링되지 않는 문법

• 이미지는 앞에서 설명한 대로 자리 표시로 바뀝니다.
• 직접 정한 스타일: 사용자 CSS, 테마, 색, 글꼴 선택은 적용되지 않습니다.
• CommonMark 밖의 확장 문법: GitHub 표와 취소선만 예외입니다. 각주, 수식, 코드로 쓴 다이어그램은 여기에 속하지 않으므로, 렌더링된 결과 대신 원본 텍스트가 그대로 보입니다.
• 일반 텍스트 파일: 파일이 사실상 마크다운이 아니라면 TXT PDF 변환이 입력한 그대로 모든 줄과 공백을 유지합니다.

해석과 페이지 배치는 모두 이 브라우저 탭에서 실행되며, 마크다운과 결과 PDF는 내 기기에 그대로 남습니다. 확인하는 방법은 여기에 있습니다.