Repolode
Enviar
marp-team

marp-team/marp-cli

Ferramenta de linha de comando que converte apresentações em Markdown com Marp e Marpit para HTML, PDF, PPTX e imagens PNG/JPEG.

Alternativa open source a:PowerPointKeynote

Ver no GitHub
Estrelas
3,909
Forks
204
Issues abertas
20
Último commit
há 2 meses

O que é?

O Marp CLI é a interface de linha de comando do Marp e de outros conversores desenvolvidos com base no framework Marpit. Ele transforma arquivos Markdown escritos na sintaxe do Marp em HTML e CSS estáticos, PDF, PowerPoint (PPTX) e imagens PNG ou JPEG. As conversões para PDF, PPTX e imagens usam uma instalação local do navegador Chrome, Edge ou Firefox.

Além de conversões pontuais, a ferramenta oferece um modo de monitoramento que recompila os arquivos quando eles mudam e atualiza a página aberta, um modo servidor que converte apresentações sob demanda via HTTP e uma janela de pré-visualização para apresentações. A saída pode incluir notas do apresentador, marcadores de estrutura do PDF e metadados como título, autor e imagem Open Graph. É possível substituir os temas ou fornecer CSS personalizado.

O Marp CLI pode ser executado com npx, instalado local ou globalmente pelo npm, usado via Docker ou baixado como binário independente. Também oferece uma API para Node.js e um arquivo de configuração (marp.config.js, .marprc ou a seção marp do package.json) para definir configurações para todo o projeto.

Recursos principais

  • 01Converte apresentações em Markdown para HTML, PDF, PPTX e imagens PNG/JPEG.
  • 02O modo de monitoramento recompila os arquivos quando eles mudam e atualiza o navegador automaticamente.
  • 03O modo servidor disponibiliza apresentações e as converte sob demanda por meio de query strings.
  • 04Janela de pré-visualização e template HTML personalizado com navegação pelo teclado.
  • 05Oferece suporte à exportação de notas do apresentador e a marcadores de estrutura do PDF.
  • 06Pode ser configurado por flags da CLI, arquivos de configuração ou uma API para Node.js.

Casos de uso

  • Criar palestras técnicas em Markdown e exportar apostilas em PDF.
  • Gerar arquivos do PowerPoint a partir de Markdown para colegas que usam o Office.
  • Automatizar a geração de apresentações em CI ou em um pipeline de documentação com Docker.
  • Criar imagens Open Graph a partir do slide de título de uma apresentação.

Início rápido

  1. 1

    Instale o Node.js v18 ou posterior

  2. 2

    Converta uma apresentação de slides para HTML com npx

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

    Converta uma apresentação de slides para PDF (requer Chrome, Edge ou Firefox)

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

Antes de usar

  • A conversão para PDF, PPTX e imagens requer a instalação do Google Chrome, Microsoft Edge ou Mozilla Firefox.
  • A opção experimental --pptx-editable também requer o LibreOffice Impress e oferece menor fidelidade na reprodução dos slides.

Em coleções

Ferramentas de CLI e terminalFerramentas de PDF, OCR e documentosGeradores de sites estáticos e ferramentas de documentação

Tópicos

#markdown#presentation#slides#pdf#pptx#cli#marp#deck#marpit

Perguntas frequentes

O que é marp-cli?
Ferramenta de linha de comando que converte apresentações em Markdown com Marp e Marpit para HTML, PDF, PPTX e imagens PNG/JPEG. O Marp CLI é a interface de linha de comando do Marp e de outros conversores desenvolvidos com base no framework Marpit. Ele transforma arquivos Markdown escritos na sintaxe do Marp em HTML e CSS estáticos, PDF, PowerPoint (PPTX) e imagens PNG ou JPEG. As conversões para PDF, PPTX e imagens usam uma instalação local do navegador Chrome, Edge ou Firefox.
marp-cli é gratuito? Qual é a licença?
marp-cli é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
marp-cli ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de marp-cli foi em 8 de set. de 2026.
Para que posso usar marp-cli?
Criar palestras técnicas em Markdown e exportar apostilas em PDF. Gerar arquivos do PowerPoint a partir de Markdown para colegas que usam o Office. Automatizar a geração de apresentações em CI ou em um pipeline de documentação com Docker. Criar imagens Open Graph a partir do slide de título de uma apresentação.
Como instalar marp-cli?
Instale o Node.js v18 ou posterior Converta uma apresentação de slides para HTML com npx: npx @marp-team/marp-cli@latest slide-deck.md Converta uma apresentação de slides para PDF (requer Chrome, Edge ou Firefox): npx @marp-team/marp-cli@latest slide-deck.md --pdf
Onde consigo marp-cli?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/marp-team/marp-cli

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados