Clean vs Business vs Academic vs Dark: 어떤 md2pdf 테마를 사용해야 할까요?

md2pdf의 테마 선택기는 작은 선택처럼 보입니다. 내보내기 버튼 위의 라디오 버튼 네 개일 뿐이니까요. 하지만 실제로는 누군가 내용을 읽기도 전에 문서의 인상을 바꿉니다. Academic으로 인쇄한 명세서는 논문처럼 보이고, Clean으로 인쇄한 고객 제안서는 저장소를 그대로 쏟아낸 것처럼 보입니다. 올바른 테마는 독자의 기대에 맞는 테마입니다.

네 테마 모두 같은 Markdown을 렌더링합니다. 차이는 서체 계열, 정렬, 코드 처리, 표 스타일, 링크 색상, 그리고 제목에 얼마나 많은 시각적 구조를 더하는지입니다. 어느 테마도 워터마크, 표지, 로고를 추가하지 않습니다. 콘텐츠는 여러분의 것입니다.

테마는 색상 교체가 아니라 인쇄 스타일시트입니다

각 테마는 미리보기 시트에 적용되고 인쇄 출력까지 이어지는 CSS 규칙 모음입니다. 따라서 테마는 다음에 영향을 줍니다:

• 제목, 본문, 표, 코드에 사용되는 글꼴.
• 본문이 왼쪽 정렬인지 양쪽 정렬인지.
• 제목 구분선의 색상과 두께.
• 코드 블록과 인라인 코드의 배경.
• 표 헤더 채우기와 테두리 색상.
• 미리보기의 링크 색상, 그리고 PDF가 이를 보존하는 경우 내보낸 파일의 링크 색상.

인쇄 스타일시트는 페이지 나눔 힌트도 처리합니다. 코드 블록, 표, 인용문, 이미지는 가능한 한 중간에서 나뉘지 않으며, 제목은 페이지 맨 아래에 홀로 남지 않습니다.

비교하기 전에 실용적인 참고 사항 하나: 코드 블록 채우기와 표 헤더 색상을 유지하려면 브라우저 인쇄 대화상자에서 배경 그래픽을 켜세요. 켜지 않아도 PDF는 읽을 수 있지만 Business와 Dark는 구조를 일부 잃습니다. 이 선택은 앱이 아니라 인쇄 대화상자에 있습니다.

Clean: 기술 문서의 기본값

Clean은 중립적인 선택입니다. 문서 전체에 인터페이스의 산세리프 서체 스택을 사용하며, 흰 배경에 짙은 회색 텍스트, 밝은 회색 코드 배경을 씁니다. 제목은 얇은 선으로 구분되고, 링크는 제품 다른 곳에서 쓰는 것과 같은 청록색을 사용합니다.

잘 맞는 용도:

• 저장소 README와 기술 명세서.
• 내부 엔지니어링 문서.
• 코드가 많은 유인물과 런북.
• 종이만큼이나 자주 화면에서 읽힐 문서.
• 세련됨보다 중립성이 중요한 감사 스냅샷.

주의할 점:

• 아주 긴 글은 밋밋하게 느껴질 수 있습니다. Clean은 효율적이지, 따뜻하지는 않습니다.
• 밝은 코드 배경은 인쇄 시 배경 그래픽에 의존합니다. 이 옵션을 끄면 코드 블록은 여전히 읽히지만 본문과의 시각적 분리를 잃습니다.
• 작은 인쇄 크기의 산세리프 본문은 긴 글을 읽을 때 세리프보다 불편할 수 있습니다.

Clean은 특정 분위기를 강요하지 않기 때문에 가장 안전한 기본값입니다. 다른 엔지니어를 위해 README를 내보낸다면 여기서 시작하세요.

Business: 보고서, 제안서, 고객 전달 문서

Business는 문서를 더 격식 있는 어조로 옮깁니다. 전체에 세리프 서체를 쓰고, 더 굵은 선이 있는 네이비 제목, 어두운 코드 블록, 옅게 착색된 표 헤더를 사용합니다. 결과물은 README보다 보고서처럼 읽히는데, 독자가 고객, 관리자, 또는 여러 부서를 아우르는 이해관계자일 때 바로 그 점이 핵심입니다.

잘 맞는 용도:

• 고객 전달 문서와 프로젝트 개요.
• 제안서, 작업 명세서, 보고서.
• 디자인된 느낌이 필요한 워크숍 유인물.
• 포트폴리오 첨부 자료와 지원 샘플.
• 다이어그램과 표가 글만큼이나 중요한 문서.

주의할 점:

• 어두운 코드 블록은 강한 시각 요소입니다. 짧은 코드 조각이 많은 문서는 줄무늬처럼 보이기 시작할 수 있습니다.
• 세리프 서체와 양쪽 정렬에 가까운 간격 때문에 긴 URL과 코드 식별자가 두드러집니다. 코드 줄을 짧게 유지하세요.
• 여기서는 배경 그래픽이 중요합니다. 없으면 어두운 코드 블록이 평범한 블록이 되고 표 헤더가 착색을 잃습니다.
• Business가 편집을 대신하지는 않습니다. Business로 인쇄한 원본 변경 로그는 여전히 원본 변경 로그처럼 읽힙니다.

외부 문서라면 Business가 보통 더 나은 첫인상을 줍니다. PDF가 나중에 덤으로 내보낸 것이 아니라 독자를 위해 준비되었다는 신호를 보냅니다.

Academic: 장문의 글과 강의 자료

Academic은 세리프 서체, 양쪽 정렬 본문, 더 따뜻하고 밝은 코드 처리를 사용합니다. 문단이 양쪽 정렬되어도 구조를 훑어볼 수 있도록 제목은 왼쪽 정렬을 유지합니다. 전체적인 인상은 제품 페이지보다 강의 자료나 논문에 가깝습니다.

잘 맞는 용도:

• 강의 패킷, 읽기 자료, 강의 노트.
• 논문과 연구 보고서.
• 코드 블록이 적은 장문 문서.
• 연구비 신청서와 학술 포트폴리오.
• 독자가 훑어보기보다 처음부터 끝까지 읽기를 기대하는 모든 문서.

주의할 점:

• 양쪽 정렬 텍스트는 긴 URL, 코드 식별자, 기술 용어 주변에 넓은 간격을 만들 수 있습니다. 긴 링크는 참조 스타일 링크로 나누거나 목록으로 옮기세요.
• 코드 블록은 읽을 수 있지만 Business보다 시각적으로 조용합니다. 이는 의도된 것입니다. Academic은 코드가 주인공이 아니라 보조 자료라고 전제합니다.
• 열이 많으면 A4에서 표가 비좁아질 수 있습니다. 열 수를 줄이거나 세부 내용을 본문으로 옮기세요.
• Academic은 빠른 설치 가이드에 잘 맞지 않습니다. 이 형식은 “처음부터 끝까지 읽으라”고 말하지만, 런북은 보통 훑어봅니다.

문서에 참고문헌 같은 섹션이 있다면 Academic의 타이포그래피가 자연스럽게 어울립니다. 앱은 인용 형식을 정리하지 않으므로 참고문헌 섹션은 Markdown에 그대로 두세요.

Dark: 화면 우선 검토, 인쇄에 안전한 출력

Dark는 유일하게 결이 다른 테마입니다. 무엇보다 화면에서 편안하게 읽도록 설계되었습니다. 어두운 네이비 배경, 밝은 텍스트, 더 밝은 링크 색상입니다. 인쇄할 때 인쇄 스타일시트는 흰 배경, 검은 텍스트, 검은 링크, 밝은 코드 블록을 강제합니다. PDF는 어두운 화면 테마를 종이로 가져가지 않습니다.

잘 맞는 용도:

• 내보내기 전에 긴 README를 화면에서 검토할 때.
• 저녁이나 어두운 환경에서 읽을 때.
• 흰 페이지의 시각적 잡음 없이 문서가 어떻게 읽히는지 확인할 때.
• 다크 모드 도구를 선호하는 팀에서 PDF를 만들 때.

주의할 점:

• 화면에서 보는 것과 PDF에서 얻는 것은 다릅니다. 항상 내보낸 파일을 열어 밝은 인쇄 처리를 확인하세요.
• Dark는 외부 문서용 브랜드 테마가 아닙니다. 고객은 미리보기가 아니라 인쇄 출력과 일치하는 PDF를 기대합니다.
• 브라우저가 배경 인쇄로 설정되어 있어도 인쇄 스타일시트가 어두운 표면을 덮어쓰지만, 코드 블록은 시각적으로 확인해 볼 필요가 있습니다.
• 테마의 화면 대비는 약한 원본 구조를 숨길 수 있습니다. 제목 단계를 건너뛴 문서도 여전히 분위기 있어 보이지만, 더 잘 정리되지는 않습니다.

Dark는 최종 문서를 위한 네 번째 시각 정체성이 아니라, 인쇄에 안전한 탈출구가 있는 읽기 모드라고 생각하세요.

나란히 비교

	Clean	Business	Academic	Dark
본문 서체	산세리프	세리프	세리프, 양쪽 정렬	화면은 산세리프, 인쇄는 밝은 처리
제목 처리	얇은 선	네이비 선	왼쪽 정렬 세리프	어두운 배경에 밝은 선, 인쇄 안전
코드 블록	밝은 회색	어두운 네이비	따뜻한 밝은색	화면은 어둡게, 인쇄는 밝게
표 헤더	중립	푸른색 착색	중립	화면은 어둡게, 인쇄는 밝게
링크 색상	청록색	파란색	검은색	화면은 밝은 파란색, 인쇄는 검은색
가장 잘 맞는 독자	엔지니어	고객, 관리자	학계, 학생	화면을 보는 작성자
가장 잘 맞는 문서	명세서, README, 런북	보고서, 제안서, 유인물	논문, 강의 패킷	검토용 사본

이 표는 규칙이 아니라 출발점입니다. 기술적인 고객은 Clean을 선호할 수 있습니다. 디자인에 민감한 엔지니어링 팀은 Business를 선호할 수 있습니다. 문서의 범주보다 문서가 해야 할 일이 더 중요합니다.

테마가 나머지 내보내기와 상호작용하는 방식

테마는 인쇄 결과의 일부일 뿐입니다. 다음 상호작용을 확인해 볼 만합니다:

목차. 목차는 문서의 서체와 링크 색상을 물려받습니다. Business에서는 네이비 제목과 파란 링크 덕분에 보고서 목차처럼 느껴집니다. Academic에서는 논문 개요처럼 읽힙니다. 목차는 제목이 세 개 이상인 문서에 생성되며, 문서가 짧으면 끌 수 있습니다.

코드 블록. Clean과 Academic은 밝은 코드 배경을, Business는 어두운 블록을, Dark는 화면에서 어두운 블록과 인쇄에서 밝은 블록을 사용합니다. 색상보다 큰 문제는 긴 줄입니다. 120자 줄은 테마와 관계없이 넘칩니다.

표. Business는 착색된 헤더를 더하고 Clean과 Academic은 중립을 유지합니다. 넓은 표는 가장 흔한 인쇄 실패 원인입니다. 표에 열이 다섯 개에서 여섯 개를 넘으면 인쇄 배율을 줄이기보다 표를 나누거나 원본의 글꼴 크기를 줄이는 것을 고려하세요.

이미지와 배지. 테마는 이미지 렌더링을 바꾸지 않지만 주변 여백을 바꿉니다. Business의 세리프 텍스트는 스크린샷을 더 그림처럼 느껴지게 하고, Clean의 산세리프 텍스트는 문서처럼 느껴지게 합니다. 깨진 이미지는 미리보기에 표시되며 내보내기를 중단하지 않습니다.

링크. Clean과 Business는 파란 링크를, Academic은 검은색을, Dark는 화면에서 밝은 파란색과 인쇄에서 검은색을 사용합니다. PDF를 흑백으로 인쇄하면 색상 차이가 사라지므로 링크 텍스트를 색에 의존하지 말고 설명적으로 작성하세요.

페이지 나눔. 인쇄 스타일시트는 코드 블록, 표, 인용문, 이미지가 가능한 한 요소 중간에서 나뉘지 않게 하고, 제목이 뒤따르는 내용과 함께 있도록 유지합니다. 이 동작은 모든 테마에 공통이지만, 긴 글이 페이지 전환을 더 많이 만드는 Academic에서 더 중요합니다.

30초 안에 고르기

다음 빠른 결정 경로를 사용하세요:

1. 독자가 명령과 코드를 훑어볼 엔지니어인가요? Clean을 고르세요.
2. 독자가 보고서를 기대하는 고객, 관리자, 검토자인가요? Business를 고르세요.
3. 코드 블록이 적은 장문의 글인가요? Academic을 고르세요.
4. 주로 화면에서 읽고 나중에 내보내나요? Dark를 고른 뒤 PDF를 확인하세요.
5. 아직 확신이 없나요? Clean을 고르세요. 문서를 가장 왜곡할 가능성이 낮습니다.

유용한 테스트: 두 후보 테마로 처음 두 페이지를 내보내 휴대폰에서 읽어 보세요. 작은 화면과 빠른 훑어보기를 견디는 테마가 보통 정답입니다.

테마보다 중요한 내보내기 전 점검

어떤 테마도 다음을 고칠 수 없습니다:

• 제목 계층. 주요 섹션에는 ##를, 하위 섹션에는 ###를 사용하세요. 단계를 건너뛰면 목차가 혼란스러워집니다.
• 코드 줄 길이. 가능하면 줄을 대략 80–90자 이내로 유지하세요.
• 표 너비. 열을 줄이고, 레이블을 짧게 하거나, 표를 나누세요.
• 이미지 경로. 저장소 기준 이미지는 저장소를 가져와야 합니다. 붙여넣은 Markdown에는 절대 URL이 필요합니다.
• 기밀 텍스트. 변환은 로컬에서 이루어지지만 PDF는 여전히 전달될 수 있습니다.
• 페이지 크기. A4와 Letter는 페이지가 다르게 나뉩니다. 받는 사람이 인쇄할 크기를 고르세요.
• 배경 그래픽. 코드 블록 채우기와 표 헤더가 디자인에 중요하면 켜세요.

권장 사항

대부분의 README 내보내기에는 Clean이 올바른 기본값입니다. 중립적이고 읽기 쉬우며, 문서를 실제와 다른 무엇인가인 척하지 않습니다. PDF가 엔지니어링 외부 누군가에게 전달할 결과물이라면 Business를 사용하세요. 문서를 글로 읽히게 하려면 Academic을 사용하세요. 최종 밝은 PDF를 만들기 전에 편안하게 검토하고 싶다면 Dark를 사용하세요.

테마는 독자에게 보내는 신호입니다. 작업에 맞는 신호를 고른 뒤 남은 노력은 콘텐츠에 쏟으세요. 명확한 도입부, 합리적인 제목 구조, 실제로 표시되는 이미지가 그것입니다. 이런 선택은 어떤 테마에서도 살아남습니다.

전체 내보내기 흐름은 GitHub README를 PDF로 변환하는 방법에서, 독자별 준비 방법은 README를 PDF로 만드는 7가지 실용 사례에서 확인하세요.