마크다운을 PDF로 만든다는 것

마크다운은 문서를 쓰기에 가장 편하고, 보내기에 가장 번거로운 형식입니다.

메모도, README도, 명세도, 보고서도 다 썼습니다. 편집기 안에서는 완벽합니다. 그런데 누군가 "PDF로 주세요"라고 합니다. 그러면 선택지는 이렇습니다. 도구 모음을 설치하거나, 워드프로세서에 붙여 넣고 서식을 손으로 고치거나, 저장소에 올려서 화면을 캡처하거나.

대신 여기에 붙여 넣으세요. 오른쪽 미리보기가 곧 PDF의 모습이고, 버튼을 누르면 파일이 됩니다.

그대로 살아남는 것

GitHub 방식 마크다운에서 기대할 만한 것은 모두 남습니다.

제목 — 모든 단계, 문서다운 여백과 함께
목록 — 글머리 기호, 번호, 중첩까지
표 — 테두리와 음영이 들어간 머리글 행
코드 — 본문 속 이런 것과, 들여쓰기가 살아 있는 코드 블록
인용, 가로줄, 굵게, *기울임*, 링크
이미지 — data URI이거나 접근 가능한 주소라면

미리보기와 PDF는 같은 스타일시트로 그려집니다. 보이는 그대로가 실제로 인쇄되는 모습입니다. 나중에 놀라게 할 두 번째 편집 단계는 없습니다.

두 가지 스타일

단정한 문서 — 세리프 글꼴에 넉넉한 줄 간격. 보고서, 제안서, 이어 읽는 글처럼 처음부터 끝까지 읽는 것에 어울립니다.
README 스타일 — 산세리프 글꼴에 밑줄 친 제목으로, 코드 저장소에서 보는 README에 가깝습니다. 기술 문서와 설명에 어울립니다.

쪽 설정

A4 또는 Letter, 세로 또는 가로, 그리고 밀리미터로 정하는 여백. 가로 방향은 폭이 넓은 표나 긴 코드 줄이 있을 때 기억해 둘 만합니다. 표가 들어가느냐 줄바꿈되느냐가 여기서 갈립니다.

쪽번호는 기본으로 켜져 있고 각 쪽 아래 가운데에 들어갑니다. 한 쪽짜리 문서에서는 잡음일 뿐이니 꺼 두세요.

기기 밖으로 나가지 않습니다

마크다운을 그리는 일도 PDF를 쓰는 일도 모두 브라우저 안에서 이루어집니다. 업로드되지 않으므로:

공개 전 명세, 사내 메모, 고객 작업물이 자리를 벗어나지 않습니다
업로드 때문에 생기는 파일 크기 제한이 없습니다
페이지만 한 번 열리면 인터넷 없이도 동작합니다
쓰던 글은 이 브라우저에 남아 다음에 와도 이어집니다. 탭을 닫아도 작업이 사라지지 않고, 이 브라우저 밖으로도 나가지 않습니다

왜 글자로 넣지 않고 그림으로 그리는가

각 쪽은 PDF 글자로 기록하는 대신 이미지로 그려서 넣습니다. 의도한 선택입니다. PDF의 표준 글꼴은 한글, 가나, 한자, 키릴 문자를 아예 담지 못하는데, 마크다운 문서는 어떤 언어로든 쓰일 수 있기 때문입니다.

그려 넣는 방식은 여러분 기기의 글꼴을 쓰므로 어떤 문자 체계든 제대로 표시됩니다. 대신 완성된 PDF의 글자는 선택할 수 없습니다. Word를 PDF로가 같은 이유로 하는 것과 똑같은 맞바꿈입니다. 선택 가능한 글자가 필요하고 문서가 라틴 문자뿐이라면, 이력서 작성기가 다른 방식의 예입니다.

이런 것을 변환합니다

코드 저장소를 쓰지 않는 사람에게 줄 README나 설명 문서
마크다운으로 적은 회의록을 문서로 넘길 때
텍스트 편집기에서 쓴 명세서나 제안서
인쇄하거나 태블릿으로 읽을 공부 노트
메일에 붙일 변경 기록이나 릴리스 노트
마크다운으로 쓰고 PDF로 나눠 주는 수업 자료

알아두면 좋은 점

마크다운 속 원시 HTML은 그리기 전에 정리되므로, 붙여 넣은 문서가 무언가를 실행할 수 없습니다
아주 긴 문서는 한 쪽당 몇 초가 걸립니다. 모든 작업은 기기 안에서 이루어집니다
인터넷의 이미지는 해당 사이트가 다른 페이지의 읽기를 허용할 때만 나타납니다. data URI로 붙여 넣은 이미지는 언제나 나옵니다
반대 방향이거나 그냥 마크다운을 쓰고 싶다면 마크다운 편집기를 쓰세요
결과를 다른 PDF와 합치려면 PDF 합치기를 쓰세요

사용 방법

왼쪽에 마크다운을 붙여 넣거나 .md 열기로 파일을 불러옵니다
오른쪽 미리보기를 확인합니다. PDF가 그 모습이 됩니다
용지 크기, 방향, 여백, 스타일을 고릅니다
필요하면 쪽번호 넣기에 체크합니다
PDF 만들기를 누른 뒤 PDF 내려받기를 누릅니다

마크다운을 PDF로