Sobre transformar Markdown em PDF
Markdown é o jeito mais fácil de escrever um documento e o mais chato de enviar um.
Você escreveu as notas, o README, a especificação, o relatório. No seu editor está perfeito. Aí alguém pede em PDF, e as opções são: instalar uma cadeia de ferramentas, colar tudo num processador de texto e consertar a formatação na mão, ou subir para um repositório e tirar print da página.
Cole aqui, em vez disso. A pré-visualização à direita é como o PDF vai ficar, e o botão transforma nisso.
O que sobrevive à viagem
Tudo o que se espera do Markdown estilo GitHub:
- Títulos — todos os níveis, com o espaçamento que um documento deve ter
- Listas — com marcadores, numeradas e aninhadas
- Tabelas — com bordas e uma linha de cabeçalho sombreada
- Código — em linha assim, e em blocos que mantêm a indentação
- Citações, linhas horizontais, negrito, *itálico* e links
- Imagens, desde que sejam data-URI ou URLs acessíveis
A pré-visualização e o PDF são desenhados a partir da mesma folha de estilo, então o que você vê é mesmo o que sai impresso. Não há uma segunda diagramação para te surpreender.
Dois estilos
- Documento sóbrio — uma fonte com serifa e entrelinha generosa. A escolha certa para um relatório, uma proposta, um texto corrido, qualquer coisa que alguém leia do começo ao fim.
- Estilo README — uma fonte sem serifa com títulos sublinhados, mais perto de como um README aparece numa plataforma de código. A escolha certa para documentação e notas técnicas.
Configuração da página
A4 ou Carta, retrato ou paisagem, e uma margem que você define em milímetros. Vale lembrar do paisagem para qualquer coisa com tabelas largas ou linhas de código longas — é a diferença entre uma tabela que cabe e uma que quebra.
Os números de página vêm ligados e aparecem centralizados no rodapé de cada folha. Desligue num documento de uma página só, onde eles só atrapalham.
Nada sai do seu aparelho
O Markdown é renderizado e o PDF é escrito dentro do seu navegador. Nada é enviado, então:
- Especificações não publicadas, notas internas e trabalho de cliente ficam onde estão
- Não há limite de tamanho por causa de um envio
- Funciona sem internet depois que a página carregou
- Seu texto fica guardado neste navegador entre as visitas, para que fechar a aba não perca o trabalho — e só neste navegador
Por que as páginas são pintadas, e não compostas
Cada página é desenhada como imagem e colocada no PDF, em vez de ser escrita como texto de PDF. Isso é proposital: as fontes padrão do PDF não conseguem codificar hangul, kana, sinogramas ou cirílico, e um documento Markdown pode estar em qualquer idioma.
Desenhar a página usa as fontes do seu próprio sistema, então toda escrita aparece direito. Em troca, o texto do PDF final não pode ser selecionado — a mesma troca que o Word para PDF faz, pelo mesmo motivo. Se você precisa de texto selecionável e o documento é só alfabeto latino, o Criador de currículo mostra como é o outro caminho.
O que as pessoas convertem
- Um README ou página de documentação, para quem não usa plataforma de código
- Atas de reunião escritas em Markdown, enviadas como documento
- Uma especificação ou proposta rascunhada num editor de texto
- Anotações de estudo para imprimir ou ler no tablet
- Um changelog ou nota de versão para anexar num e-mail
- Material de aula escrito em Markdown e distribuído em PDF
Bom saber
- HTML cru dentro do seu Markdown é limpo antes de renderizar, então um documento colado não consegue executar nada
- Um documento muito longo leva alguns segundos por página — todo o trabalho é local
- Imagens da internet só aparecem se o site permitir que outra página as leia; imagens coladas como data-URI sempre funcionam
- Para o caminho contrário, ou só para escrever Markdown, use o Editor de Markdown
- Para juntar o resultado com outro PDF, use Juntar PDF
Como usar
- Cole seu Markdown à esquerda, ou aperte Abrir .md para carregar um arquivo
- Confira a pré-visualização à direita — é assim que o PDF vai ficar
- Escolha o tamanho da página, a orientação, a margem e o estilo
- Marque Adicionar números de página se quiser
- Aperte Criar PDF e depois Baixar PDF
Ferramentas relacionadas
- Editor de Markdown — escrever Markdown com barra de ferramentas e pré-visualização ao vivo
- Word para PDF — o mesmo motor de PDF, partindo de um .docx
- PDF para texto — recuperar texto puro de um PDF
- Juntar PDF — unir este PDF a outros
- Numerar páginas de um PDF — numerar um PDF existente
- Comprimir PDF — diminuir o arquivo antes de enviar
