Perguntas frequentes
Respostas para as dúvidas mais comuns sobre o MarkPDF
Que sintaxe de Markdown é suportada?
O MarkPDF suporta a sintaxe CommonMark: títulos, parágrafos, ênfase, listas, links, imagens, blocos de código, citações e linhas horizontais, além de tabelas no estilo GitHub, texto riscado e links automáticos. Fórmulas são escritas entre $ … $ e $$ … $$.
PDF de texto ou de imagem: qual a diferença?
Há duas formas de exportar. "Baixar PDF (texto)" usa o mecanismo de impressão do navegador: o texto pode ser selecionado e pesquisado, os links funcionam e o arquivo fica pequeno; escolha "Salvar como PDF" na janela de impressão. "Download rápido (imagem)" salva as páginas como imagens com um clique (cerca de 180 DPI em A4): fica idêntico à pré-visualização, mas o texto não pode ser selecionado e nem buscadores nem sistemas de triagem de currículos (ATS) conseguem lê-lo. Em navegadores internos de apps (WhatsApp, Facebook, Instagram…) a impressão pode não funcionar, por isso lá a versão em imagem aparece primeiro.
Fórmulas matemáticas e destaque de código são suportados?
Sim. Blocos de código são destacados com highlight.js (mais de 190 linguagens), e fórmulas entre $ … $, $$ … $$, \( … \) ou \[ … \] são exibidas com KaTeX.
Existe limite de tamanho de arquivo?
Tudo é processado no navegador, então o limite real depende do seu aparelho. Em geral, arquivos Markdown de dezenas de KB (dezenas de milhares de palavras) funcionam sem problema. Documentos muito grandes podem demorar um pouco mais para aparecer.
Como escolho a fonte certa?
Para português, a fonte padrão já serve, e as fontes para árabe, hindi e outros sistemas de escrita são carregadas automaticamente. Para chinês simplificado escolha Noto Sans SC ou Source Han Sans; para chinês tradicional, Noto Sans TC; para japonês, Noto Sans JP; e para coreano, Noto Sans KR. Para documentos em vários idiomas, Source Han Sans é a melhor opção.
Quanto tempo leva a conversão?
Depende do tamanho e da complexidade do documento. Um artigo comum de 2000 palavras costuma levar 2-3 segundos. Documentos longos com muitas tabelas ou blocos de código podem levar 5-10 segundos. Tudo acontece no seu navegador, sem transferência pela rede.
Vocês guardam o conteúdo dos meus documentos?
Não. Todo o processamento do MarkPDF acontece no seu navegador e o conteúdo nunca é enviado para os nossos servidores. A privacidade foi o principal motivo para escolhermos renderizar no navegador.
Dá para converter vários arquivos de uma vez?
A versão atual converte um documento por vez. A conversão em lote ainda não está disponível.
Posso personalizar o estilo do PDF?
No painel de configurações você escolhe a fonte, o tamanho da fonte, o tamanho do papel (A4, Carta, A5) e as margens; as escolhas ficam salvas neste aparelho. CSS personalizado e cabeçalho/rodapé ainda não estão disponíveis.
Existe uma API?
Por enquanto não há API. O MarkPDF roda inteiro no navegador. Se você precisa gerar PDF no seu próprio aplicativo, veja as bibliotecas de código aberto que usamos (markdown-it + html2pdf.js).
Quais navegadores são suportados?
O MarkPDF funciona em todos os navegadores modernos: Chrome 80+, Firefox 75+, Safari 14+ e Edge 80+. Para a melhor experiência, use uma versão recente do Chrome ou do Edge. O Internet Explorer não é suportado.
Funciona no celular?
Sim. O layout se adapta a celulares e tablets. Em telas pequenas, o editor e a pré-visualização ficam um embaixo do outro; alterne entre eles com o botão "Pré-visualizar".
Dá para inserir imagens?
Sim. Use a sintaxe de imagem do Markdown para inserir imagens da internet. A versão atual não permite enviar imagens do seu aparelho: hospede a imagem num serviço de imagens e use o link dela.
Posso exportar para outros formatos?
Por enquanto o formato principal é PDF. A exportação para HTML está em desenvolvimento, e outros formatos como Word (.docx) podem chegar em versões futuras.
Onde encontro ajuda?
O MarkPDF não oferece suporte individual. A maioria das dúvidas é respondida nestas perguntas frequentes, no tutorial e nos guias de solução de problemas, que explicam em detalhe problemas de fonte, codificação e diagramação.