자주 묻는 질문

MarkPDF 관련 FAQ

어떤 Markdown 문법을 지원하나요?

CommonMark 문법(제목, 문단, 강조, 목록, 링크, 이미지, 코드 블록, 인용문, 구분선)과 GitHub 스타일 표, 취소선, 자동 링크를 지원합니다. 수식은 $ … $와 $$ … $$로 쓸 수 있습니다.

텍스트 PDF와 이미지 PDF의 차이는?

두 가지 저장 방식이 있습니다. "PDF 다운로드 (텍스트)"는 브라우저 인쇄 기능을 사용해 텍스트 선택·검색이 가능하고 링크가 작동하며 파일이 작습니다. 인쇄 창에서 "PDF로 저장"을 선택하세요. "빠른 다운로드 (이미지)"는 한 번에 페이지를 이미지로 저장합니다(A4 기준 약 180 DPI). 미리보기와 똑같이 보이지만 텍스트를 선택하거나 검색할 수 없고 채용 시스템(ATS)도 읽지 못합니다. 카카오톡·Facebook·Instagram 등의 앱 내 브라우저에서는 인쇄가 안 될 수 있어 이미지 버전을 먼저 보여 드립니다.

수식과 코드 하이라이팅을 지원하나요?

네. 코드 블록은 highlight.js(190개 이상의 언어)로 강조되며, $ … $, $$ … $$, \( … \), \[ … \] 수식은 KaTeX로 렌더링됩니다.

파일 용량 제한이 있나요?

모든 처리가 브라우저 내에서 이루어지므로, 제한은 기기 성능에 따라 다릅니다. 수만 단어(수십 KB급)는 문제없으며, 대용량은 렌더 시간이 늘어날 수 있습니다.

CJK 폰트는 어떻게 선택하나요?

문서 언어에 따라 선택: 중문 간체=Noto SC 또는 Source Han Sans, 번체=TC, 일본어=JP, 한국어=KR. 다국어 혼합 문서는 Source Han Sans를 추천합니다.

변환 속도는 얼마나 빠른가요?

문서 길이/난이도에 따라 다르지만, 보통 2천 단어 기준 2~3초면 완료. 표나 코드가 많아도 5~10초 이내. 모든 작업이 네트워크 없이 브라우저 내에서 처리됩니다.

내 문서 내용이 저장되나요?

아니오. 모든 처리는 브라우저에서만 이루어지며, 문서 내용은 서버로 전송되지 않습니다. 우리는 개인정보 보호를 최우선 가치로 삼습니다.

일괄 변환(여러 문서 동시 변환)이 가능한가요?

현재 버전은 한 번에 문서 하나를 변환합니다. 일괄 변환은 아직 지원하지 않습니다.

PDF 스타일/테마 커스터마이즈가 되나요?

설정 패널에서 폰트, 글자 크기, 용지(A4, Letter, A5), 여백을 고를 수 있으며 설정은 이 기기에 저장됩니다. 사용자 CSS와 머리글/바닥글은 아직 지원하지 않습니다.

API 제공은 되나요?

아직 별도의 API는 없습니다. MarkPDF는 100% 프론트엔드에서 동작하므로, 자체 프로젝트에 통합하려면 markdown-it + html2pdf.js 등 오픈소스 라이브러리를 참고하세요.

지원 브라우저는 어떻게 되나요?

Chrome 80+, Firefox 75+, Safari 14+, Edge 80+ 등 최신 주요 브라우저 대부분 지원합니다. 최고 성능을 원한다면 Chrome/Edge 최신 버전을 추천합니다. IE는 지원하지 않습니다.

모바일에서도 쓸 수 있나요?

네! 반응형 디자인 적용으로 스마트폰/태블릿 모두 지원. 작은 화면에선 미리보기·편집 전환 버튼으로 분할이 아닌 전환 방식으로 동작합니다.

이미지 삽입이 가능한가요?

네! 표준 Markdown 이미지 문법으로 인터넷 이미지 삽입이 됩니다. 현재는 로컬 이미지 업로드는 미지원이며, 이미지를 이미지 호스팅(Imgur, sm.ms 등)에 업로드 후 링크를 사용하시면 됩니다.

PDF 외 다른 포맷 내보내기도 되나요?

현재는 PDF만 공식 지원. HTML 내보내기는 개발 중이며, Word(.docx) 등도 장기적으로 고려 중입니다.

문제가 생기면 어디서 답을 찾나요?

MarkPDF는 일대일 지원을 제공하지 않습니다. 대부분의 질문은 이 FAQ, 사용법, 문제 해결 가이드에서 답을 찾을 수 있으며, 가이드에서 폰트·인코딩·레이아웃 문제를 자세히 다룹니다.