Conversor

Conversor de Markdown para PDF

Markdown para PDF é um conversor de impressão do navegador: cole Markdown, escolha um tamanho de papel e um tema, e use Imprimir / Salvar como PDF. O documento é impresso localmente e nada é enviado.

# Quarterly Research Report

中文摘要 · 日本語要約 · 한국어 요약

This note mixes Latin, CJK, a table, math, and a code sample.

## Results

| Region | Revenue |
| --- | --- |
| 東京 | ¥12.4M |
| 서울 | ₩980M |
| 上海 | ¥9.1M |

The growth rate is $r = \frac{\Delta x}{x}$.

```python
def growth(previous: float, current: float) -> float:
    return (current - previous) / previous
```

Como funciona

Como converter Markdown em PDF

O que você pode colar

  • Qualquer Markdown: CommonMark mais tabelas, listas de tarefas e riscado do GitHub Flavored Markdown
  • A renderização roda no seu navegador: nada é enviado enquanto você digita
  • Não precisa de conta para pré-visualizar, copiar ou baixar
  • Sem limite de tamanho fixo; um documento muito grande fica limitado pela memória do seu navegador
Markdown para PDF: editor Markdown à esquerda vira uma página PDF impressa à direita

Por que usar

Por que usar este conversor de Markdown para PDF

Um arquivo Markdown não tem geometria de página própria. Este conversor adiciona tamanho de papel, margens e regras de quebra de página, e depois entrega o resultado ao motor de impressão do seu navegador.

Imprime local, nada é enviado

O PDF é gerado pelo motor de impressão do seu navegador. O Markdown nunca sai do seu dispositivo.

Tamanho de papel e margens

Escolha A4 ou Carta, vertical ou horizontal, e margens normais, estreitas ou largas antes de imprimir.

Temas para documentos diferentes

Os temas Github, document e compact mudam as fontes, o espaçamento e a cor dos blocos de código sem alterar o Markdown.

Números de página

Adicione um número de página no canto ou no centro de cada página impressa, com o estilo do tema atual.

Pilha de fontes ciente de CJK

A folha de estilos de impressão lista fontes de sistema chinesas, japonesas e coreanas antes do fallback latino, para relatórios com vários sistemas de escrita.

O mesmo renderizador HTML da API

O documento é construído a partir do mesmo HTML higienizado de POST /v1/convert/markdown/html, e depois envolvido no CSS de impressão que seu navegador converte em PDF.

O problema

Por que o Markdown precisa de regras de página antes de ser impresso

Markdown não tem geometria de página

Um arquivo Markdown descreve títulos e parágrafos, não o tamanho de página, as margens nem onde uma página deve quebrar.

Tabelas e blocos de código longos se quebram mal

Sem regras de quebra de página, uma linha de tabela ou um bloco de código delimitado podem ser cortados ao meio no fim de uma página impressa.

CJK e escritas mistas precisam das fontes certas

O texto chinês, japonês e coreano pode cair em um glifo ausente ou em um comportamento de quebra de linha diferente conforme o navegador e o sistema operacional.

Converter Markdown em PDF: texto copiado e colado bagunçado ao lado de uma estrutura Markdown limpa

O que é preservado

O que este conversor de Markdown para PDF preserva

Tamanho de página e margens
Uma regra @page fixa o tamanho do papel (A4 ou Carta), a orientação e a margem antes que seu navegador abra o diálogo de impressão.Source: CSS Paged Media Module
Os títulos podem começar uma nova página
Títulos de nível 1 podem saltar para uma nova página por padrão, então cada seção de nível superior começa limpa; o primeiro título do documento não.Source: CSS Paged Media Module
Tabelas e código evitam quebrar no meio da página
Tabelas e código delimitado estão marcados para não se quebrar por dentro, então o navegador move o bloco inteiro para a página seguinte em vez de parti-lo.Source: CSS Paged Media Module
Números de página com contadores CSS
Um número de página opcional é gerado com um contador de página CSS, colocado à esquerda, ao centro ou à direita do rodapé.Source: CSS Paged Media Module
O mesmo HTML higienizado da API
O documento imprimível parte do mesmo HTML higienizado de CommonMark e GFM que POST /v1/convert/markdown/html usa.Source: CommonMark Spec

CSS de impressão por trás deste conversor de Markdown para PDF· folha de estilos de impressão do markitdown.ai: tema github, A4, números de página ativados

@page { size: A4 portrait; margin: 25mm; }@page { @bottom-center { content: counter(page); font-size: 10pt; color: var(--md-muted); } }h1 { break-before: page; }article.md-document > h1:first-child { break-before: auto; }table, pre { break-inside: avoid; }

Casos de uso

Casos de uso da conversão de Markdown para PDF

Quando uma nota em Markdown precisa virar um arquivo paginado que alguém possa abrir sem um leitor de Markdown — é para isso que serve converter Markdown para PDF online no navegador.

Relatórios e notas de pesquisa

Converta um relatório em Markdown em um PDF paginado para compartilhar com alguém que não tem um leitor de Markdown.

Documentos multilíngues

Imprima notas que misturam escrita latina com texto chinês, japonês ou coreano usando a pilha de fontes ciente de CJK.

Apostilas rápidas a partir de um README

Produza uma versão imprimível da documentação ou de um README sem instalar uma ferramenta de PDF à parte.

Arquivar uma nota em Markdown

Guarde um instantâneo datado e paginado de uma nota antes que ela continue mudando, sem enviá-la a lugar nenhum.

Markdown para PDF online: página PDF impressa usada como relatório, para impressão e arquivamento

Impressão pelo navegador

Esta ferramenta constrói um documento imprimível no seu navegador e o entrega ao próprio diálogo Imprimir / Salvar como PDF do navegador. A geração de PDF no servidor está planejada mas não disponível, então a API hoje não tem endpoint de PDF. Se você precisa de um PDF a partir de um processo automatizado hoje, renderize HTML higienizado com POST /v1/convert/markdown/html e imprima esse HTML com uma ferramenta que você controle, ou use esta página de forma interativa para um documento pontual. Esta seção será atualizada se um endpoint de servidor for lançado; até então, trate a rota de impressão do navegador como o único caminho aceito para Markdown para PDF neste produto.

Papel, margens, tema

O tamanho de papel e as margens decidem quanto espaço os parágrafos, as tabelas e o código têm em cada página: uma margem mais estreita cabe mais por página mas pode apertar uma tabela densa, enquanto uma margem mais larga se lê com mais conforto ao custo de páginas extras. Os três temas mudam as fontes, o espaçamento e o fundo dos blocos de código sem tocar no Markdown em si, então trocar de tema é uma forma segura de comparar uma nota interna compacta com um documento pensado para um leitor externo. Confira sempre a pré-visualização paginada depois de uma mudança, porque um ajuste que fica bem em uma nota curta pode empurrar uma tabela através de uma quebra de página em um relatório mais longo.

  • A4 combina com a maior parte do público não americano; Carta combina com documentos voltados aos EUA.
  • Margens estreitas colocam mais conteúdo por página; as largas se leem com mais conforto.
  • Os números de página ajudam um relatório impresso e grampeado a se manter em ordem.

Multilíngue e código

O Markdown que mistura texto latino com caracteres chineses, japoneses ou coreanos depende das fontes realmente instaladas na máquina que imprime, então o mesmo arquivo pode paginar de forma diferente em dois computadores ainda que a fonte Markdown seja idêntica. Confira a pré-visualização no dispositivo a partir do qual você vai imprimir, sobretudo em um relatório longo em que um glifo ausente poderia empurrar um título para a página errada. Blocos de código e URLs longas sem espaços se comportam de forma parecida: estão marcados para não se quebrar no meio da linha, então o navegador move o bloco inteiro para a página seguinte em vez de partir um comando que alguém poderia copiar.

FAQ

Perguntas sobre Markdown para PDF

Markdown para PDF envia meu texto?

Não. Imprime local —nada é enviado para produzir o PDF—: ele é gerado inteiramente pelo motor de impressão do seu navegador.

Existe uma API de Markdown para PDF no servidor?

Ainda não. POST /v1/convert/markdown/pdf não existe, então chamá-lo devolve 404. Renderize HTML com POST /v1/convert/markdown/html e imprima isso, ou use a ferramenta do navegador desta página.

Posso escolher A4 ou Carta?

Sim. O tamanho de papel, a orientação, as margens e os números de página são opções locais do editor.

Ele lida com texto chinês, japonês ou coreano?

A folha de estilos de impressão lista fontes de sistema CJK antes do fallback latino. Confira a pré-visualização paginada antes de imprimir, porque a disponibilidade de fontes muda conforme o dispositivo.

Os títulos sempre começam uma nova página?

Por padrão, um título de nível 1 salta para uma nova página, exceto o primeiro título do documento; isso pode ser desativado.

Preciso de uma conta para imprimir Markdown como PDF?

Não. Colar, pré-visualizar e imprimir funcionam sem login.

Haverá depois um arquivo PDF gerado no servidor?

A geração de PDF no servidor está planejada. Hoje esta página usa o diálogo de impressão do seu navegador e não há endpoint de PDF no servidor.

Converta Markdown para PDF onde quiser.

Teste de graça: não precisa se cadastrar.