Converta Markdown para PDF sem perder o documento
Markdown foi feito para telas que rolam. Um PDF tem páginas, e páginas têm bordas. A maioria dos conversores ignora essa diferença: entregam o arquivo para um navegador, pressionam imprimir e devolvem o que sair dali. Por isso uma tabela perde suas últimas quatro colunas, um título acaba isolado no rodapé de uma página e o logo no topo de um README aparece como uma linha de HTML cru impressa como texto. Aqui, o documento é diagramado para o papel primeiro, e depois você fica sabendo o que foi preciso fazer para chegar lá.
Tabelas que ainda cabem no papel
Uma tabela em Markdown não traz larguras de coluna. A sintaxe não tem onde colocá-las, então um conversor que passa a tabela direto para o navegador torce para que ela caiba. Aqui, cada tabela é medida antes de ser desenhada e ajustada ao papel que você escolheu. Uma tabela de caminhos de arquivos com quatorze colunas ainda fica dentro das margens, com valores longos quebrando linha em vez de ultrapassarem a borda, e o resultado informa que precisou fazer isso.
A parte mais sutil do problema acontece na segunda página. Uma tabela longa normalmente deixa sua linha de cabeçalho para trás na primeira página, então o leitor vê uma grade de números sem rótulo. Aqui, o cabeçalho se repete em cada página em que a tabela aparece, e uma linha nunca é cortada ao meio por uma quebra de página.
Código que sobrevive à margem
Código entre cercas mantém seu realce de sintaxe e o nome da linguagem. Linhas longas quebram para que você veja que quebraram, em vez de serem cortadas onde o papel termina. Um PDF não tem barra de rolagem, então uma linha que não quebra é uma linha com o lado direito faltando. Blocos indentados, cercas sem linguagem e código em linha também aparecem como são.
As imagens do seu README
Um logo e uma fileira de badges de build quase nunca são escritos em Markdown. Não há como centralizar uma imagem nele, então arquivos README usam HTML cru. Um conversor que se recusa a renderizar HTML geralmente escapa o código em vez de simplesmente ignorá-lo, o que faz o documento abrir com um monte de tags de imagem impressas como texto. Aqui, a marcação é removida e as imagens e palavras dentro dela são mantidas, então o topo do documento fica como deveria.
As imagens são buscadas e incorporadas ao arquivo, em vez de apenas vinculadas, então o PDF funciona offline e continuará funcionando daqui a um ano. Se alguma não puder ser buscada, o resultado conta e informa isso, em vez de simplesmente deixar um espaço em branco onde deveria haver uma imagem.
Seus títulos viram navegação
Cada PDF traz uma árvore de favoritos construída a partir dos seus próprios títulos, então um documento longo pode ser navegado pela barra lateral em vez de rolar tudo. Peça uma página de sumário e você recebe uma clicável, na profundidade de títulos que preferir. Um único título no topo é lido como o título do documento e fica fora da lista, como acontece em um livro, não em um capítulo.
Notas de rodapé continuam sendo notas de rodapé, com marcador elevado e link de volta para a linha que você estava lendo. Listas de tarefas mantêm suas caixas, marcadas ou não. Avisos, notas e dicas mantêm sua barra colorida. O front matter no topo do arquivo é tratado como metadado e não aparece na página. Listas de definições, tachado, citações aninhadas e até três níveis de listas aninhadas são renderizados como são.
Ele informa o que não conseguiu fazer
Cada conversão retorna um breve relatório: quantas páginas, direção do texto, quantas tabelas, quantos blocos de código, quantas imagens foram incorporadas e quantas não puderam ser buscadas. Se uma fonte não tinha determinado caractere, ele lista qual foi. Se você pediu um sumário e o documento não tem títulos para colocar nele, isso é informado em vez de entregar um arquivo com uma página em branco na frente. Um conversor que esconde suas próprias falhas é o motivo pelo qual as pessoas deixam de confiar em conversores.
Alfabetos que não são latinos
As fontes viajam dentro do PDF, então um documento abre igual mesmo em um computador que não tenha nenhuma delas instalada. Texto da direita para a esquerda é avaliado bloco a bloco, não para o arquivo inteiro, o que importa porque um documento técnico nesse tipo de escrita costuma ser metade latino, cheio de caminhos de arquivos e nomes de classes, e ainda assim lido da direita para a esquerda. Código entre cercas fica fora dessa decisão e sempre é alinhado da esquerda para a direita, e o resto do layout é espelhado corretamente: marcadores, barras de citação e colunas de tabela se ajustam. Onde um alfabeto não tem itálico, o destaque é feito pelo peso da fonte, não por inclinar letras que nunca foram desenhadas para isso.
O que não faz
LaTeX não é renderizado. Um bloco entre cifrões é impresso como texto. Mermaid também não é desenhado: uma cerca marcada como mermaid vira um bloco de código com rótulo. Chinês, japonês e coreano ficam fora das fontes que a ferramenta traz, então caracteres nesses alfabetos são relatados como ausentes em vez de serem substituídos por tentativas. São limites, não defeitos, e estão escritos aqui para que ninguém os descubra só depois de enviar o arquivo.
A parte prática
Envie do seu dispositivo, do Google Drive ou colando um link para um arquivo. Arquivos Markdown são aceitos em qualquer uma de suas extensões usuais, assim como texto simples. O papel pode ser A3, A4, A5, Letter, Legal ou Tabloid, retrato ou paisagem, com margens estreitas, normais ou largas. Numeração de páginas e realce de sintaxe vêm ativados, a menos que você desligue. Envie um arquivo e recebe um PDF; envie vários e eles chegam em um ZIP, ou em um único PDF mesclado com numeração contínua se você pedir. O texto permanece texto real, então pode ser selecionado, pesquisado e copiado, em vez de virar uma imagem de palavras.
O que você recebe
- Tabelas que permanecem dentro das margens, com a linha de cabeçalho repetida em cada página
- Código com realce de sintaxe e linhas longas quebradas, nunca cortadas
- Imagens incorporadas ao arquivo, incluindo as escritas em HTML cru
- Uma árvore de favoritos a partir dos seus títulos, e uma página de sumário clicável quando quiser
- Fontes incorporadas no PDF, para que o arquivo fique igual em qualquer computador
- Um relatório escrito sobre tudo que o conversor não conseguiu fazer, incluindo glifos e imagens ausentes
E agora?
Trabalhando a partir de um arquivo Word? Word para PDF segue o mesmo caminho até o papel. Junte o resultado ao resto de um relatório usando Unir PDF. Depois, reduza o tamanho do arquivo antes de enviar com Comprimir PDF.