O Markdown é ótimo para escrever, mas quem recebe o documento muitas vezes espera uma página web ou um PDF. A boa notícia: converter Markdown é fácil, e na maioria dos casos você não precisa de um conjunto complicado de ferramentas.
Abaixo estão quatro formas de fazer isso, da mais rápida à mais configurável, e uma série de dicas para deixar o resultado com cara profissional.
Comparação rápida
| Método | HTML | Instalação | Ideal para | |
|---|---|---|---|---|
| Exportação de um editor no navegador | ✅ | ✅ (impressão) | Nada | Documentos do dia a dia, compartilhamento rápido |
| VS Code + extensão | ✅ | ✅ | Editor + extensão | Quem já escreve no VS Code |
| Pandoc | ✅ | ✅ | Pandoc (+ um motor de PDF) | Livros, artigos acadêmicos, pipelines automatizados |
| Um script (markdown-it, marked) | ✅ | — | Node.js | Sites personalizados e etapas de build |
1. Exportar de um editor no navegador
O caminho mais rápido é um editor que exporta diretamente. No Markdown Preview Editor, abra ou cole seu documento — na versão online ou na sua própria cópia — e use os botões do cabeçalho:
- HTML cria um único arquivo
.htmlindependente. Estilos, realce de código, fórmulas, diagramas e as imagens que você abriu junto com o documento ficam incorporados, então o arquivo aparece corretamente em qualquer computador e pode ser anexado a um e-mail ou publicado em qualquer lugar do jeito que está. - Imprimir abre a janela de impressão do navegador. Escolha Salvar como PDF como destino para obter um PDF. Só o documento renderizado é impresso — sem barra de ferramentas, sem editor.
- Salvar baixa o código Markdown como um arquivo
.md.
Como tudo acontece no navegador, isso também funciona para documentos que você prefere não enviar a um conversor online.
Como obter um PDF limpo pela janela de impressão
- Defina as Margens como Padrão ou Mínimas, conforme a quantidade de texto que você quer por página.
- Desative Cabeçalhos e rodapés para remover a data e o URL das bordas da página.
- Ative Gráficos de plano de fundo se quiser o fundo dos blocos de código e as faixas das tabelas.
- Use o tema claro para imprimir — economiza tinta e é mais fácil de ler no papel.
2. VS Code com uma extensão
O VS Code tem uma visualização de Markdown integrada, mas nenhum botão de exportação. Extensões como Markdown PDF ou Markdown Preview Enhanced adicionam comandos para exportar HTML e PDF. É prático se o VS Code já é o seu editor; o visual do resultado depende da extensão, e algumas baixam um navegador headless no primeiro uso.
3. Pandoc — o conversor universal
O Pandoc converte entre dezenas de formatos e é a ferramenta padrão para livros, artigos acadêmicos e documentação automatizada. Depois de instalado, a conversão é um único comando:
bash# Markdown para uma página HTML completa
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown para PDF (precisa de um motor de PDF, p. ex. uma distribuição LaTeX)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown para Word, se alguém fizer questão
pandoc report.md -o report.docx
Sem --standalone, o Pandoc gera apenas um fragmento de HTML — útil se você for inseri-lo em uma página existente. A saída em PDF exige um motor separado: uma distribuição LaTeX ou um motor baseado em HTML, como o WeasyPrint. O ponto forte do Pandoc é o controle: modelos, citações, seções numeradas e referências cruzadas.
4. Algumas linhas de JavaScript
Se o Markdown faz parte do seu próprio site ou processo de build, uma biblioteca é a opção mais flexível. Com o markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Plugins adicionam notas de rodapé, listas de tarefas, fórmulas e mais. Lembre-se de que a saída só é tão segura quanto a entrada: se o Markdown vem de outras pessoas, sanitize o HTML (por exemplo, com o DOMPurify) antes de publicá-lo.
Dicas para um HTML e um PDF melhores
Comece com um título claro
Os conversores tiram o título do documento do nome do arquivo, do primeiro título ou de metadados explícitos. Dê a cada documento um nome de arquivo descritivo e um único título #, e o HTML e o PDF exportados serão fáceis de reconhecer na pasta de downloads ou em uma aba do navegador.
Deixe as imagens ao lado do documento
Use caminhos relativos como images/chart.png e mantenha os arquivos na mesma pasta. Ao abrir a pasta inteira no Markdown Preview Editor, as imagens são resolvidas e incorporadas na exportação HTML. Imagens remotas que não são carregadas na visualização também não são incorporadas.
Controle as quebras de página
O Markdown não tem sintaxe para quebra de página. Em documentos impressos, comece as seções grandes com um título ## e mantenha as tabelas curtas — os navegadores evitam dividir linhas de tabela, mas uma tabela enorme vai continuar na página seguinte de qualquer jeito. Em ferramentas que permitem HTML puro e estilos embutidos, como o Pandoc, você pode inserir <div style="page-break-after: always"></div>.
Confira fórmulas e diagramas antes de exportar
Na maioria das ferramentas, fórmulas e diagramas são renderizados por bibliotecas JavaScript. Confira-os primeiro na visualização — veja nossos guias sobre fórmulas matemáticas em Markdown e diagramas Mermaid. Na exportação HTML do Markdown Preview Editor, eles são salvos como marcação e imagens prontas, então o arquivo exportado não precisa de nenhum script.
Escolha o tema de propósito
Exportações HTML escuras são agradáveis na tela, mas uma má escolha para o papel. Exporte pensando no meio que o leitor vai usar.
Perguntas frequentes
Como converter Markdown para PDF de graça?
Abra o documento em um visualizador de Markdown como o Markdown Preview Editor, clique em Imprimir e escolha Salvar como PDF na janela de impressão. Para uma saída automatizada ou em formato de livro, use a ferramenta de linha de comando gratuita Pandoc.
Como converter Markdown para HTML sem instalar nada?
Use um editor no navegador com exportação para HTML. O Markdown Preview Editor cria um arquivo HTML independente, com os estilos incluídos, direto no seu navegador.
As imagens são incluídas no HTML exportado?
As imagens locais que você abriu junto com o documento são incorporadas no arquivo HTML, então ele funciona sozinho. Imagens que ficam em servidores remotos não são incorporadas.
Posso converter Markdown para Word (DOCX)?
Sim, com o Pandoc: pandoc input.md -o output.docx. Outra opção é exportar o HTML e abri-lo no Word, que mantém a maior parte da formatação.