Executando verificação de segurança...
12
gabrielhmsantos
1 min de leitura ·

Pitch: TypDocs: uma ferramenta para transformar Markdown em PDF profissional

Algum tempo atrás eu percebi um padrão no meu fluxo de trabalho.

Eu estava usando cada vez mais IA para gerar documentação de projetos. A IA entregava um Markdown bem estruturado, organizado, bonito de ler no editor. Até aí, perfeito.

O problema começava quando eu precisava enviar isso para o cliente.

Converter .md para PDF parecia algo simples… mas na prática sempre faltava alguma coisa.
Ou não dava para colocar a logo no cabeçalho.
Ou o rodapé não existia.
Ou o espaçamento ficava estranho.
Ou simplesmente o PDF não tinha “cara” de documento corporativo.

Depois de testar várias ferramentas online e sempre sentir que estava quase bom, mas nunca profissional o suficiente, eu decidi fazer o que sempre faço quando algo me incomoda no fluxo: construir a minha própria solução.

Assim nasceu o TypDocs.

A ideia é simples: pegar Markdown (muitas vezes gerado por IA) e transformar em um PDF com mais controle visual, com cabeçalho com imagem, rodapé configurável e ajustes de estilo, pensando em documentos empresariais de verdade.

Por enquanto ele não é SaaS, não salva dados em servidor, tudo roda no navegador usando apenas localStorage. A intenção agora não é monetizar, é validar. Entender se essa dor é só minha ou de mais gente.

Queria ouvir de vocês:

Vocês também sentem essa fricção no MD → PDF?
O que seria essencial para considerar uma ferramenta dessas “pronta para uso profissional”?

Carregando publicação patrocinada...
3
clacerda

Cara, isso é uma ferida que sangra há décadas na indústria.

MD para PDF é o tipo de problema que parece trivial até você precisar que o header da página 3 tenha a logo da empresa alinhada à esquerda e o número da página à direita, com uma linha fina separando do conteúdo. Sim só o da página 3.
Aí você descobre o buraco é muito fundo!!!

Primeiro, o fato de não ser SaaS já me deixa 100% mais simpático ao projeto.

Agora, a pulga atrás da orelha, e aqui eu jogo meu viés de quem usa Pandoc todo dia e já sofreu com TeX até a alma:

O problema que vai explodir assim que alguém quiser:

  • Cross-references ("conforme visto na página X", onde X é variável)
  • TOC com números de página corretos (não aquele link clicável que só funciona no digital)
  • Evitar viúvas e órfãs.

O Pandoc resolve isso com TeX, mas aí você entra no inferno de compilar templates e descobrir que mudar a fonte ou a margen exige um prompt ou stackoverflow.

Agora, se você conseguiu fazer um engine que lê CSS e gera PDF com box model de verdade, headers/footers com contadores de página, e cross-refs paginados funcionando... aí você tem ouro.

Literalmente. Porque hoje em dia ou você paga 400 dólares pro PrinceXML, ou você aceita que o PDF vai ter "cara de site impresso" e não "cara de documento técnico".

A sugestão que você não pediu mas vai ganhar anyway:

Não vire SaaS. Sério. Não adianta ter Stripe se você pode ter npm install -g typdocs (ou melhor, um binário single-file).

Se você conseguir fazer o que o Pandoc com TeX, mas com a DX de "edite esse style.css", você resolve um porblema ENORME (potencial de unicórnio, ai sim pensando em algo tipo o overleaf).

Até lá, eu sigo aqui de makefile + docker image com pandoc + tex que pesa 4GB só pra gerar um relatório de 3 páginas rs.

Sucesso no projeto!

3
2
gabrielhmsantos
  • Autor
    Autor

Gotenberg vai em um caminho diferente até devido a infra, mas pretendo no futuro usar ele ou outra lib como conversor final do arquivo enquanto o preview serve apenas para pré-visualização (algo parecido com o apitemplate.io). E meu intuito é internalizar a geração dos PDF da minha plataforma propria de propostas (hoje utilizo o apitemplate.io)

1
1
klawdyo

Rapaz... acho uma dor muito, muito específica.
Não sei se tu converte em Saas.
Todo mundo que eu conheço faz isso no word e salva como PDF. Infinitamente mais simples.
Quando se trata de gestão de referências como o que o carinha falou acima, procura um openleaf ou o novo prism da openai.
Mas o core da sua aplicação tem potencial pra ser um bom projeto opensource. Eu mesmo já sofri quand criei um servidor de impressão pra cuidar dos meus pedidos em rede. Pra não lidar diretamente com os comandos escpos, ou qztray ou rawbt, eu tive a ideia de gerar pdf a partir de markdown por ser mais legível para humanos e usar isso como padrão. Funciona. Mas deu trabalho pra caramba pra acertar o estilo.
Se for algo mais personalizável, provavelmente eu mudaria esse motor de renderização do meu app

1
flaviohbonfim

cara eu passo pelo mesmo, monto varias documentaçoes em markdown usando IA e depois pra converter em um pdf é complicado, a ideia é bem legal, acho que uma coisa que senti falta foi o suporte a mermaid diagrams, eu sempre uso nas minhas documentaçoes, e testei a conversao de algumas no typdocs e nao tem o suporte para mermaid o que acaba fazendo falta.
parabens pelo projeto e ideia

1
2
gabrielhmsantos
  • Autor
    Autor

Obrigado por sinalizar a questão de 1 página na impressão, aparentemente foi algum bug/cache do deploy da vercel fiz o redeploy e aparentemente corrigiu.

Na questão do travamento do navegador, não sei dizer se é algum gargalo de hardware do computador, pois realizei testes e comecei a ter gargalos em torno de 40 paginas.

Mas já estou alinhando escopo para migração do motor de renderização, talvez irei optar por .md > LaTeX > PDF, e deixar o backend resp.

1
Dants

Aqui na empresa, como eu sofrí com isso... Parece simples de início mas a medida que o problema vai escalando isso se torna uma pedra no sapato. Queria que essa solução existisse antes, parabéns.