마크다운을 출판용 전자책으로 바꾸는 여정은 어렵지 않습니다. 셰프가 주방을 차리듯, 당신만의 완벽한 출판 환경을 구축해 보세요.
많은 사람들이 "코딩은 어렵다"고 하지만, 사실 요리와 똑같습니다.
1. 마크다운 파일: 당신이 정성껏 준비한 최고급 식재료입니다.
2. Node.js: 요리를 할 수 있게 불을 피우고 가스를 공급하는 주방
시스템입니다.
3. Pandoc: 재료를 썰고, 익히고, 플레이팅하는 만능 조리 기구입니다.
NpxMagicDoc은 이 모든 것을 총괄하여, 클릭 한 번에 당신의 재료를 5성급 호텔 요리(전자책)로 변환해주는 수석
셰프입니다.
전문적인 출판을 위해 컴퓨터에 딱 두 가지만 설치해 주세요. 이 과정은 한 번만 하면 됩니다.
NpxMagicDoc이 살아 움직이는 토대입니다. 공식 사이트(nodejs.org)에서 LTS(추천) 버전을 다운로드하여 설치하세요. 설치 후 아래 명령어로 잘 설치되었는지 확인해 봅니다.
node --version # v18.0.0 이상이면 합격!
문서를 재조립하는 실제 엔진입니다. 운영체제에 따라 아래 명령어를 복사하여 터미널에 붙여넣으세요.
터미널(Terminal)을 열고 입력:
brew install pandoc
명령 프롬프트(CMD)를 열고 입력:
winget install --id JohnMacFarlane.Pandoc
터미널을 열고 입력:
sudo apt-get update && sudo apt-get install pandoc
터미널을 열고 입력:
sudo dnf install pandoc
컴퓨터에 아무것도 없는 상태에서 시작하시나요? 걱정 마세요!
Node.js, Pandoc, WeasyPrint 설치부터 PDF 변환까지 모든 과정을 상세하게 안내해 드립니다.
프로그램을 실행하는 방법은 크게 두 가지입니다. 당신의 성향에 맞는 방식을 골라보세요.
컴퓨터에 도구를 영구적으로 남기지 않고, 필요할 때만 구름(클라우드)에서 불러와서 씁니다.
npx markdown-to-document-cli@latest interactive
도구를 내 컴퓨터 가방에 영구적으로 넣고 다닙니다. 한 번 설치하면 인터넷 없이도 주문을 내릴 수 있습니다.
npm install -g markdown-to-document-cli # 이제 아래처럼 짧게 부르세요! m2d interactive
셰프와 대화하며 책을 완성하는 가장 쉽고 세련된 과정입니다.
변환할 마크다운 파일(.md)의 경로를 입력하세요.
가장 쉬운 방법: 파일을 터미널 창으로 드래그 앤 드롭하면 경로가 마법처럼 자동 입력됩니다!
⚠️ 이런 경로는 피하세요:
# ❌ 백슬래시가 포함된 경로 /Users/username/My\ Documents/file.md
✅ 이렇게 입력하세요:
# 방법 1: 드래그 앤 드롭 (추천!) # 방법 2: 따옴표로 감싸기 "/Users/username/My Documents/file.md"
자동 수정 기능: 백슬래시, 따옴표, 공백 등이 포함된 경로도 자동으로 정리됩니다!
마법사가 당신의 원고를 순식간에 읽고 분석합니다. "이미지가 많으니 이 스타일을 쓰세요!"라고 추천해 주면, ⚡ 빠른 변환을 눌러 즉시 작업을 끝내거나 ⚙️ 상세 설정에서 15가지 표지와 11가지 스타일을 직접 고를 수 있습니다.
잠시만 기다리면 원고와 같은 폴더에 .epub(태블릿/폰용) 또는 .pdf(출력/PC용) 파일이 생성됩니다. 당신의 첫 번째 책이 탄생한 순간입니다!
PDF를 만들려면 "PDF 제작 도구"가 필요합니다. 마치 빵을 굽기 위해 오븐이 필요한 것처럼요!
❌ xelatex not found 또는 PDF 엔진을 찾을 수 없습니다
이 메시지는 "오븐이 없어서 빵을 구울 수 없어요"라는 뜻입니다. 아래 3가지 오븐 중 하나만 설치하면 해결됩니다!
가장 쉽고 빠른 방법! 한글도 완벽하게 지원합니다.
pip install weasyprint
💡 Python이 없다면? python.org에서 먼저 설치하세요.
한글 폰트를 아름답게! 전문 출판 수준의 품질을 원한다면 이걸로!
# macOS brew install --cask basictex # Linux sudo apt-get install texlive-xetex
⚠️ 설치 후 터미널을 다시 시작하세요!
오븐이 제대로 설치되었는지 확인해 봅시다:
# WeasyPrint 확인 weasyprint --version # XeLaTeX 확인 xelatex --version
버전 번호가 나오면 성공! 🎉 이제 다시 PDF 변환을 시도해 보세요.
여러 개를 설치했다면, 원하는 엔진을 직접 선택할 수 있습니다:
# WeasyPrint로 PDF 만들기 m2d document.md --pdf-engine weasyprint # XeLaTeX로 PDF 만들기 m2d document.md --pdf-engine xelatex # 자동 선택 (기본값) m2d document.md --pdf-engine auto
결과물을 더 완벽하게 만드는 작가들의 비밀 도구입니다.
원고 맨 위에 아래 내용을 적어두면 마법사가 제목과 저자를 자동으로 인식합니다.
--- title: "나의 멋진 책" author: "이름" coverTheme: "apple" ---
옵시디언의 ![[이미지]]나 [[내부링크]] 문법도 걱정 마세요. 셰프가 변환 과정에서 표준 마크다운으로 자동 교정해 드립니다.
타이포그래피 프리셋, 표지 테마, 고급 옵션 등 모든 기능을 상세하게 설명합니다. 초보자부터 전문가까지 필요한 모든 정보가 담겨 있습니다.
PDF 엔진 오류, 이미지 문제, 한글 깨짐 등 자주 발생하는 문제와 해결 방법을 단계별로 안내합니다.
💡 빠른 도움말이 필요하신가요?
터미널에서 언제든지 도움말을 확인할 수 있습니다
m2d --help m2d check m2d list-presets