Markdown PDF 변환기

Markdown PDF 변환기는 Markdown 소스 텍스트를 고정된 PDF 문서로 변환합니다.

Markdown은 제목, 단락, 강조, 링크, 목록, 표, 인용구, 코드 및 기타 문서 요소에 일반 텍스트 구문을 사용합니다. 변환기는 이 구조를 해석하고, 지원되는 기술적 콘텐츠를 렌더링하고, 인쇄 스타일을 적용하여 Markdown 에디터 없이도 공유, 검토, 보관 또는 인쇄할 수 있는 PDF를 생성합니다.

“MD to PDF”도 같은 의미입니다. MD는 Markdown의 흔한 약어이며, .md는 Markdown 문서에 주로 사용되는 파일 확장자입니다.

.md 파일은 일반 텍스트 Markdown 문서입니다. SolConverter는 .md 및 .txt 소스 파일을 수락하고 온라인 워크플로우를 통해 지원되는 Markdown 콘텐츠를 PDF로 변환합니다.

이 기능은 Markdown을 편집 가능한 소스로 유지하되, 클라이언트, 동료, 학생, 검토자 또는 Markdown을 다루지 않는 사람들을 위해 안정적인 문서가 필요한 경우에 유용합니다.

동일한 작업을 설명하는 일반적인 표현은 다음과 같습니다:

• Markdown to PDF
• MD to PDF
• Markdown 파일에서 PDF로
• .md 파일에서 PDF로
• Markdown을 PDF로 변환
• Markdown을 PDF로 내보내기
• Markdown을 PDF로 저장

이러한 모든 변환 요구 사항이 이 페이지에서 처리됩니다.

SolConverter는 기술 문서 및 일반 문서에서 일반적으로 사용되는 Markdown 구조를 렌더링합니다.

지원되는 콘텐츠는 다음과 같습니다:

• ATX 및 Setext 제목;
• 단락, 줄 바꿈 및 수평선;
• 굵게, 기울임꼴 및 취소선 텍스트;
• 중첩된 목록을 포함한 순서 있는 목록 및 순서 없는 목록;
• 확인란이 있는 GFM 작업 목록;
• 인용구 및 중첩된 인용구;
• 인라인 코드 및 펜스 코드 블록;
• Markdown 링크, 웹 자동 링크 및 이메일 자동 링크;
• 왼쪽, 가운데, 오른쪽 정렬이 포함된 GFM 표;
• 제어된 rowspan 및 colspan이 포함된 안전한 원시 HTML 표;
• details, summary, kbd, sub, sup, figure, 및 figcaption과 같은 문서 요소;
• 제목 앵커;
• 인쇄되는 콘텐츠가 아닌 메타데이터로 취급되는 파일 시작 부분의 YAML 프런트 매터(front matter).

형식이 잘못된 코드 펜스나 구분 기호는 가능한 한 로컬에 유지되므로, 서식 문제가 문서의 나머지 부분에 영향을 주지 않습니다.

SolConverter는 지원되는 LaTeX 및 MathML을 MathJax SVG로 렌더링합니다. SVG 출력은 PDF를 확대하거나 인쇄할 때도 선명함을 유지합니다.

수식 파이프라인은 Markdown 파싱 전에 식을 인식하므로 밑줄, 별표, 디스플레이 구분 기호 및 수식 환경이 Markdown 파서에 의해 변경되지 않도록 보호합니다.

지원되는 수식 입력은 다음과 같습니다:

• $...$ 및 \(...\)를 사용한 인라인 수식;
• $$...$$ 및 \[...\]를 사용한 디스플레이 수식;
• equation, align, gather, multline, split, cases와 같은 일반적인 AMS 환경;
• 분수, 제곱근, 거듭제곱, 지수, 합, 곱, 적분, 극한 및 급수;
• 행렬, 행렬식, 배열 및 텐서 표기법;
• 미적분학, 미분방정식, 선형대수학, 확률, 통계, 물리학 및 화학 표기법;
• Presentation MathML 및 기본 Content MathML 연산;
• \ce{...}로 작성된 화학식;
• \newcommand 및 \DeclareMathOperator와 같은 문서 범위 매크로.

긴 덧셈 식은 페이지 가장자리에서 잘리거나 읽기 어려울 정도로 축소되는 대신 최상위 연산자에서 분할될 수 있습니다. 디스플레이 수식은 브라우저가 페이지에 블록을 맞출 수 있는 경우 함께 유지됩니다.

SolConverter는 형식이 잘못된 수식을 문제가 발생한 위치에 격리합니다.

LaTeX 또는 MathML 블록을 안전하게 렌더링할 수 없는 경우, 변환기는 중립적인 소스 대체 텍스트를 보존하고 그 뒤에 오는 유효한 콘텐츠를 계속 렌더링할 수 있습니다. 다이어그램과 이미지에도 동일한 국소적 실패 처리 방식이 사용됩니다.

이는 긴 기술 문서에서 중요합니다. 하나의 손상된 수식, 하나의 사용할 수 없는 이미지 또는 하나의 무효한 다이어그램으로 인해 주변의 모든 유효한 페이지가 자동으로 삭제되어서는 안 됩니다.

지원되는 Mermaid 펜스 블록은 PDF 내에서 SVG로 렌더링됩니다. ZenUML은 로컬에 번들로 제공되는 Mermaid 외부 다이어그램 통합을 통해 지원됩니다.

각 유효한 다이어그램은 독립적으로 렌더링되며 사용 가능한 페이지 너비로 제한됩니다. 다이어그램 렌더링에 실패하면 SolConverter는 소스가 포함된 로컬 대체 콘텐츠를 삽입하고 나머지 문서 처리를 계속합니다.

현재 지원되는 다이어그램 엔진은 Mermaid 및 ZenUML입니다. PlantUML, Graphviz, D2, WaveDrom, BPMN, Nomnoml 및 전체 TikZ는 현재 지원되지 않습니다.

기술 문서에는 설명, 명령, 설정 및 소스 코드가 혼합되어 있는 경우가 많습니다. SolConverter는 코드 펜스 언어가 인식되면 Highlight.js를 사용하여 구문 강조를 적용합니다.

코드 출력에는 다음이 포함됩니다:

• 전용 고정폭 글꼴;
• 펜스 블록의 시각적인 배경, 테두리 및 패딩;
• 코드 펜스 정보 문자열로부터의 언어 감지;
• 언어가 인식되지 않을 때 안전한 소스 출력;
• 코드 내의 수식 구분 기호 해석 방지;
• 우횡서(RTL) 문서 내 코드의 좌횡서(LTR) 격리.

따라서 PDF는 원본 소스를 보존하면서 코드를 주변의 텍스트와 시각적으로 분리합니다.

SolConverter는 콘텐츠에서 문서 방향을 감지하고 적절한 글꼴 대체(fallback)를 사용하여 다국어 PDF를 지원합니다.

지원되는 텍스트 시나리오는 다음과 같습니다:

• 베트남어 및 확장 라틴 문자;
• 아랍어 및 히브리어 레이아웃;
• 중국어, 일본어, 한국어 텍스트;
• 인도계 문자;
• 키릴 문자 및 그리스 문자;
• 혼합 스크립트 문서;
• 결합 문자;
• 사용 가능한 글꼴 범위에 따른 다양한 유니코드 기호 및 이모지.

기본 문서 방향이 우횡서이더라도 수식과 코드는 좌횡서로 유지됩니다.

SolConverter는 공개 HTTP 및 HTTPS 이미지뿐만 아니라 PNG, GIF, JPEG, WebP, SVG 형식의 유효한 base64 데이터 이미지를 지원합니다.

이미지는 가로세로 비율을 유지하면서 페이지 너비로 제한됩니다. 지원되는 이미지 메타데이터에는 대체 텍스트(alt text), 제목, 안전한 크기, 정렬, 그림 및 캡션이 포함됩니다.

사용할 수 없거나 잘못된 이미지는 대체 텍스트가 포함된 로컬 자리 표시자(placeholder)로 대체됩니다. 변환기는 PDF 전체를 실패 처리하는 대신 나머지 Markdown 처리를 계속 진행합니다.

보안을 위해 로컬 경로, localhost 주소, 사설 IP 리터럴, javascript: URL 및 지원되지 않는 스키마는 차단됩니다. 리포지토리 상대 경로의 자산 폴더는 업로드된 Markdown 파일와 함께 자동으로 패키징되지 않습니다.

변환기는 기술 문서, 메모, 보고서 및 인쇄 출력물에 일관된 PDF 레이아웃을 적용합니다.

현재 웹 양식은 다음을 사용합니다:

• A4 페이지 크기;
• 세로 방향;
• 가독성 높은 출력을 위한 여백 관리;
• 현재 페이지 / 총 페이지 수 형식의 페이지 번호 매기기;
• 소스 파일 이름을 기반으로 한 출력 제목;
• 인쇄된 배경.

렌더링 시스템은 기본적인 인쇄 레이아웃 보호 조치도 적용합니다. 페이지 하단에 제목만 남겨지는 현상을 방지하고, 텍스트 블록의 첫 행/끝 행 분리(widow/orphan)를 줄이며, 브라우저가 지원하는 경우 표 헤더를 반복하고, 충분한 페이지 공간이 있는 경우 코드 블록, 표 행, 그림, 이미지, 다이어그램 및 디스플레이 수식이 나누어지는 것을 방지합니다.

단순한 Markdown은 내보내기 쉽습니다. 그러나 긴 기술용 Markdown은 수식, 다이어그램, 표, 코드, 다국어 텍스트, 외부 이미지 및 페이지 매김이 모두 상호 작용하므로 더 어렵습니다.

SolConverter는 이러한 까다로운 사례를 중심으로 설계되었습니다. Markdown-to-PDF 파이프라인에는 MathJax SVG 렌더링, Mermaid 및 ZenUML, 구문 강조, 유니코드 및 RTL 지원, 새니타이제이션(위험요소 제거), 네트워크 제어, 블록 수준 실패 격리, 작업 진행률, 별도의 미리보기 및 다운로드 결과가 포함되어 있습니다.

2026년 8월 4일에 완료된 내부 스트레스 테스트에서 렌더러는 333개의 MathJax 수식이 포함된 가상의 92개 섹션 문서에서 156페이지 분량의 PDF를 생성했습니다. 또한 로컬 오류 처리 및 줄 바꿈을 검증하기 위해 의도적으로 잘못 구성된 MathML과 긴 84개 항의 식도 테스트에 포함되었습니다. 이는 내부 테스트 조건일 뿐 모든 문서가 동일한 결과를 낼 것이라는 보장은 아닙니다.

업로드된 Markdown에는 원시 HTML, 이미지 URL 및 자동으로 신뢰해서는 안 되는 기타 콘텐츠가 포함될 수 있습니다.

SolConverter는 허용 목록(allowlist)을 사용하여 렌더링된 HTML을 새니타이즈하고, 스크립트 및 이벤트 처리기를 제거하고, 안전하지 않은 URL을 거부하고, 표 스팬을 제한하고, 제한적인 콘텐츠 보안 정책(CSP)을 적용하며, 이미지 정책을 벗어나는 브라우저 요청을 차단합니다.

유효한 데이터 이미지는 네트워크 요청 없이 렌더링할 수 있습니다. 공개 원격 이미지는 이미지 정책을 통해 허용되는 반면, 로컬, 사설 및 지원되지 않는 대상은 차단됩니다.

변환이 시작되지 않은 경우 새 업로드는 15분 후에 만료됩니다. 성공적인 변환 후 출력이 확인되면 소스가 삭제됩니다. 실패한 입력은 원래 15분 만료 창 내에서 만료됩니다. 완료된 PDF는 최대 2시간 동안 유지됩니다. 전체 수명 주기는 개인정보 처리방침을 참조하십시오.

Markdown은 문서 작성 및 버전 관리에 효율적입니다. PDF는 문서의 고정된 외관과 널리 지원되는 배포 형식이 필요할 때 유용합니다.

다음과 같은 경우에 Markdown을 PDF로 변환하는 것이 유용할 수 있습니다:

• 소스 리포지토리 외부로 기술 문서를 보낼 때;
• 고정된 보고서, 사양서, 제안서 또는 런북을 전달할 때;
• 인쇄 가능한 학습 노트나 교육 자료를 작성할 때;
• 비기술 분야의 독자에게 README 또는 변경 로그를 배포할 때;
• 페이지 기반 형식으로 수식 및 다이어그램을 검토할 때;
• 변경되는 문서의 특정 버전을 보관할 때;
• Markdown 에디터 없이 문서를 공유할 때;
• 편집 가능한 Markdown 소스를 보존하고 별도의 배포용 파일을 생성할 때.

온라인 Markdown PDF 변환기는 로컬 툴체인을 구성하지 않고 직접 업로드, 관리형 렌더링, 미리보기 및 다운로드 워크플로우를 원할 때 가장 적합합니다.

오프라인 변환, 사용자 정의 템플릿, 임의의 CSS, 인용 처리, 스크립트 기반 빌드 파이프라인 또는 리포지토리 내부의 일괄 변환이 필요한 경우 Pandoc 또는 에디터 확장 프로그램과 같은 로컬 도구가 더 나은 선택일 수 있습니다.

SolConverter는 업로드된 개별 문서에 대한 관리형 Markdown-to-PDF 렌더링에 중점을 둡니다. 현재는 완전한 Pandoc 인용 지원, 임의의 사용자 CSS, 자동 PDF 북마크, 패키징된 상대 경로 자산 폴더 또는 모든 다이어그램 언어를 지원하지 않습니다.

기술 문서

아키텍처 메모, API 설명서, 런북, 릴리스 문서, 사양서 및 내부 가이드를 안정적인 PDF로 변환합니다.

수학 및 과학 문서

지원되는 LaTeX, MathML, 행렬, 수식, 화학 표기법 및 긴 식을 PDF 내부의 SVG 기반 수식으로 렌더링합니다.

개발자 문서

코드 펜스, 인라인 코드, 표, 작업 목록, 다이어그램 및 구조화된 설명을 리포지토리 외부에서 검토할 수 있는 하나의 문서로 결합합니다.

다국어 보고서

베트남어, 한중일(CJK) 문자, 아랍어, 히브리어, 키릴 문자, 그리스 문자, 인도계 문자 및 혼합된 좌횡서/우횡서 콘텐츠가 포함된 PDF를 생성합니다.

노트, 보고서 및 제안서

Markdown으로 작성한 다음 인쇄, 승인, 공유 또는 보관을 위한 고정 문서로 생성합니다.

소스 형식이나 희망하는 출력이 다른 경우 다른 SolConverter 도구를 사용하십시오.

• 파일을 Markdown으로 변환
• PDF를 Markdown으로 변환
• Word를 Markdown으로 변환
• HTML을 Markdown으로 변환
• Excel을 Markdown으로 변환
• CSV를 Markdown으로 변환
• 데이터 변환기 찾아보기
• JSON을 CSV로 변환
• CSV를 JSON으로 변환
• 기술용 Markdown-to-PDF 가이드 읽기