Como criei o MarkFlow: O diário de um desenvolvedor

Ainda me lembro daquela terça-feira à noite. Eram 23h e eu tinha acabado de terminar a documentação técnica da nossa nova API.

O conteúdo estava lindo — escrito em Markdown, com estrutura limpa, blocos de código perfeitos e diagramas Mermaid válidos explicando o fluxo de dados. Senti aquela satisfação que todo desenvolvedor conhece quando o README.md está polido com perfeição.

Então, apareceu uma notificação do Slack do meu gerente de projeto:

“Ei, ótimo trabalho na documentação. Você pode me enviar isso como um documento do Word? A equipe jurídica precisa revisar com o 'Controlar Alterações' ativado, e eles não usam Markdown.”

Suspirei. “Claro, me dê cinco minutos.”

Famosas últimas palavras.

O pesadelo dos “cinco minutos”

Abri meu terminal e executei um comando rápido do Pandoc. pandoc docs.md -o docs.docx

Abri o resultado no Word. Meu coração afundou.

• As tabelas estavam quebradas. As colunas estavam esmagadas e os cabeçalhos desalinhados.
• Os diagramas haviam sumido. Meus belos gráficos Mermaid eram apenas blocos de código nus.
• O destaque de sintaxe havia desaparecido. O código Python parecia texto simples, difícil de ler.

“Tudo bem”, pensei. “Vou tentar um conversor online.”

Pesquisei no Google “Markdown to Word converter” e cliquei no primeiro resultado. Pediu para eu fazer upload do meu arquivo. Parei. Este documento continha endpoints de API internos e lógica proprietária. De jeito nenhum eu enviaria isso para um servidor aleatório sem uma política de privacidade clara.

Então, fiz o que qualquer desenvolvedor desesperado faria. Abri o Word em uma tela, o VS Code na outra, e comecei a copiar e colar.

Passei as próximas duas horas indentando listas manualmente, tirando screenshots dos meus diagramas para colá-los como imagens e reaplicando estilos de negrito. À 1 da manhã, eu estava exausto e frustrado. Eu não estava programando; estava lutando com um processador de texto.

A realização

Naquela noite, percebi duas coisas:

1. Markdown é ótimo para escrever, mas o mundo funciona no Word. Não podemos escapar disso.
2. As ferramentas existentes forçam você a escolher: ou passar horas configurando ferramentas CLI como Pandoc, ou sacrificar sua privacidade para conversores na nuvem.

Eu não queria nenhum dos dois. Eu queria uma ferramenta que respeitasse minha privacidade (processamento local) e respeitasse minha formatação (suporte GFM).

Então, criei o MarkFlow.

Construindo para mim (e para você)

Comecei a construir o MarkFlow como um pequeno utilitário para meu próprio uso. O objetivo era simples:

• Deve ser local. Quero converter contratos confidenciais ou documentação extensa sem que os dados saiam do meu navegador.
• Deve lidar com as coisas “difíceis”. Tabelas, listas de tarefas e, sim, destaque de sintaxe para blocos de código.
• Deve ser rápido. Arrastar, soltar, pronto.

Quando mostrei a primeira versão para minha colega, os olhos dela brilharam. “Espera, ele mantém a formatação da tabela? E eu não preciso instalar Python?”

Foi aí que eu soube que isso não deveria ficar apenas como um script no meu laptop.

Por que o “Local-First” importa para mim

Em 2026, a privacidade de dados não é um luxo; é um requisito. Construí o MarkFlow com uma arquitetura única onde o mecanismo de conversão é executado diretamente no seu navegador web.

Ao usar o MarkFlow, você não está enviando seu arquivo para mim. Você está essencialmente usando um aplicativo poderoso que por acaso vive em um site. Isso significa que você pode converter seus NDAs, rascunhos de patentes e diários privados com zero medo de vazamento de dados.

Da minha frustração à sua produtividade

Hoje, o MarkFlow cresceu daquela frustração noturna para uma ferramenta robusta na qual milhares de usuários confiam.

• Chega de tabelas quebradas.
• Chega de cores de código faltando.
• Chega de ansiedade com privacidade.

Criei isso para que você nunca precise passar sua noite de terça-feira lutando com a formatação do Word. Concentre-se no conteúdo; deixe o MarkFlow lidar com a apresentação.

Experimente com seu arquivo .md mais recente. Espero que economize as duas horas que eu nunca vou recuperar.

— O Desenvolvedor do MarkFlow