Repolode
marp-team

marp-team/marp-cli

Marp 및 Marpit Markdown 슬라이드 덱을 HTML, PDF, PPTX, PNG/JPEG 이미지로 변환하는 CLI 도구입니다.

대체할 수 있는 제품:PowerPointKeynote

스타
3,907
포크
205
열린 이슈
20
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Marp CLI는 Marp 및 Marpit 프레임워크 기반의 다른 변환기를 위한 명령줄 인터페이스입니다. Marp 구문으로 작성된 Markdown 파일을 정적 HTML과 CSS, PDF, PowerPoint(PPTX), PNG 또는 JPEG 이미지로 변환합니다. PDF, PPTX, 이미지로 변환하려면 로컬에 설치된 Chrome, Edge 또는 Firefox 브라우저를 사용합니다.

일회성 변환 외에도 파일이 변경되면 다시 빌드하고 열린 페이지를 새로 고치는 watch 모드, HTTP를 통해 요청 시 덱을 변환하는 server 모드, 발표용 미리보기 창을 제공합니다. 출력에 발표자 노트, PDF 아웃라인, 제목·작성자·Open Graph 이미지 등의 메타데이터를 포함할 수 있습니다. 테마를 재정의하거나 사용자 지정 CSS를 제공할 수도 있습니다.

Marp CLI는 npx로 실행하거나 npm을 통해 로컬 또는 전역으로 설치하고, Docker로 사용하거나 독립 실행형 바이너리로 다운로드할 수 있습니다. 또한 Node.js API와 프로젝트 전반의 설정을 위한 구성 파일(marp.config.js, .marprc 또는 package.json의 marp 섹션)도 제공합니다.

핵심 기능

  • 01Markdown 슬라이드를 HTML, PDF, PPTX, PNG/JPEG 이미지로 변환합니다.
  • 02watch 모드는 변경 사항이 있으면 다시 빌드하고 브라우저를 자동으로 새로 고칩니다.
  • 03server 모드는 덱을 제공하고 쿼리 문자열을 통해 요청 시 변환합니다.
  • 04키보드 탐색을 지원하는 미리보기 창과 사용자 지정 HTML 템플릿을 제공합니다.
  • 05발표자 노트 내보내기와 PDF 아웃라인을 지원합니다.
  • 06CLI 플래그, 구성 파일 또는 Node.js API로 설정할 수 있습니다.

활용 사례

  • Markdown으로 기술 발표 자료를 작성하고 PDF 배포 자료로 내보내기.
  • Office를 사용하는 동료를 위해 Markdown에서 PowerPoint 파일 생성하기.
  • Docker를 사용해 CI 또는 문서 파이프라인에서 슬라이드 빌드 자동화하기.
  • 덱의 첫 슬라이드에서 Open Graph 이미지 만들기.

빠른 시작

  1. 1

    Node.js v18 이상 설치

  2. 2

    npx로 슬라이드 덱을 HTML로 변환

    npx @marp-team/marp-cli@latest slide-deck.md
  3. 3

    슬라이드 덱을 PDF로 변환 (Chrome, Edge 또는 Firefox 필요)

    npx @marp-team/marp-cli@latest slide-deck.md --pdf

사용 전 알아둘 점

  • PDF, PPTX 및 이미지 변환에는 Google Chrome, Microsoft Edge 또는 Mozilla Firefox가 설치되어 있어야 합니다.
  • 실험적인 --pptx-editable 옵션을 사용하려면 LibreOffice Impress도 필요하며, 슬라이드 재현성이 낮아집니다.

포함된 컬렉션

토픽

자주 묻는 질문

marp-cli은(는) 무엇인가요?
Marp 및 Marpit Markdown 슬라이드 덱을 HTML, PDF, PPTX, PNG/JPEG 이미지로 변환하는 CLI 도구입니다. Marp CLI는 Marp 및 Marpit 프레임워크 기반의 다른 변환기를 위한 명령줄 인터페이스입니다. Marp 구문으로 작성된 Markdown 파일을 정적 HTML과 CSS, PDF, PowerPoint(PPTX), PNG 또는 JPEG 이미지로 변환합니다. PDF, PPTX, 이미지로 변환하려면 로컬에 설치된 Chrome, Edge 또는 Firefox 브라우저를 사용합니다.
marp-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
marp-cli은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
marp-cli은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. marp-cli의 마지막 커밋은 2026년 9월 8일입니다.
marp-cli은(는) 어디에 사용할 수 있나요?
Markdown으로 기술 발표 자료를 작성하고 PDF 배포 자료로 내보내기. Office를 사용하는 동료를 위해 Markdown에서 PowerPoint 파일 생성하기. Docker를 사용해 CI 또는 문서 파이프라인에서 슬라이드 빌드 자동화하기. 덱의 첫 슬라이드에서 Open Graph 이미지 만들기.
marp-cli는 어떻게 설치하나요?
Node.js v18 이상 설치 npx로 슬라이드 덱을 HTML로 변환: npx @marp-team/marp-cli@latest slide-deck.md 슬라이드 덱을 PDF로 변환 (Chrome, Edge 또는 Firefox 필요): npx @marp-team/marp-cli@latest slide-deck.md --pdf
marp-cli은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/marp-team/marp-cli

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트