Markdown para imagem nas redes sociais: tamanhos, temas e um fluxo repetível
Uma publicação técnica longa falha muitas vezes porque o leitor tem de percorrer uma parede de texto. Transformar a parte mais contundente numa imagem dá a essa ideia uma segunda oportunidade: passa a ser um cartão que as pessoas conseguem ler, guardar e partilhar. A questão é como fazer isto de forma consistente sem abrir uma ferramenta de design todas as vezes.
O fluxo deste guia parte de uma fonte Markdown e produz uma imagem pronta a publicar. Vai escolher uma tela, um tema legível, escrever texto alternativo e reutilizar o mesmo processo na publicação seguinte. Os exemplos usam o MarkdownToImage e foram verificados com a respetiva documentação da API a 3 de agosto de 2026.
Uma imagem compensa quando a mensagem cabe num ecrã, beneficia de formatação que uma publicação de texto achata, ou precisa de ser partilhada como ficheiro autónomo. Código, tabelas e listas de verificação são os casos mais claros: continuam legíveis numa imagem e perdem essa legibilidade numa publicação de texto simples.
Texto simples costuma ser a melhor escolha quando o conteúdo é longo, precisa de edição, ou tem de ser pesquisável e copiável. Não transforme um artigo inteiro numa imagem. Transforme a parte que merece um segundo olhar e ligue de volta à publicação completa.
Mantenha a mensagem de origem em Markdown e renderize variantes para canais diferentes em vez de desenhar cada imagem à mão. Uma fonte pode tornar-se um cartão largo do LinkedIn, uma publicação quadrada e uma atualização estreita com telas e temas diferentes.
Isto importa porque a alternativa escala mal. Editar três ficheiros de imagem separados significa três oportunidades para introduzir uma gralha, e mudar uma frase seis semanas depois significa encontrar e refazer os três. Quando a fonte é Markdown, corrige uma linha e reexporta.
Guarde essa fonte junto do restante conteúdo, não numa ferramenta de design. Um ficheiro .md curto no mesmo repositório da documentação é suficiente e dá-lhe histórico de versões de graça: quando alguém perguntar por que motivo o cartão do mês passado dizia outra coisa, a resposta está no registo de commits.
É por isso que o fluxo começa com um bloco Markdown pequeno. Mantenha a mensagem curta, use um cabeçalho e deixe o renderizador tratar da tipografia.
Este Markdown é pequeno o suficiente para verificar a tipografia antes de usar conteúdo real:
# Deployment complete
Environment: **production**
- [x] Database migrated
- [x] Health checks passing
- [ ] Post-deploy review
`status: healthy`
Cole-o no MarkdownToImage, escolha uma tela de 1200 pixéis de largura e exporte. O cartão renderizado é a linha de base para todas as outras variantes.
Use um exemplo deliberadamente pequeno como este na primeira renderização, em vez de conteúdo real. Exercita os elementos que falham mais vezes — texto em negrito, listas de tarefas, código em linha — e é curto o suficiente para detetar um problema de espaçamento ou contraste num relance. Quando o exemplo renderizar como pretende, troque para a mensagem real e mantenha as mesmas definições.
O gerador expõe três controlos que moldam o resultado: largura, qualidade e o formato de saída.
width define a largura de renderização em pixéis, de 200 a 2560, com 800 por omissão. quality é o fator de escala do dispositivo de 1.0 a 3.0, com 2.0 por omissão. A altura efetiva em pixéis segue a proporção do conteúdo, pelo que um cartão de 1200 pixéis de largura dá texto nítido na maioria dos feeds sociais.
Uma tela de 1200 pixéis é um ponto de partida seguro: é larga o suficiente para se manter nítida em ecrãs de alta densidade e estreita o suficiente para manter o comprimento de linha legível. Para uma publicação do LinkedIn com ligação, a plataforma recomenda uma proporção de 1,91:1, cerca de 1200 x 627 pixéis, e imagens com mais de 200 pixéis de largura. Mantenha o Markdown de origem estreito para o renderizador não criar uma tabela demasiado larga.
O parâmetro format suporta PNG, JPEG, WebP ou PDF. O PNG mantém código e diagramas nítidos; use-o para cartões sociais.
Escolha um tema com contraste suficiente para o feed, não apenas para um editor claro. Temas claros leem-se bem em aplicações brancas; temas escuros destacam-se em feeds em modo escuro. O tema afeta todo o cartão, enquanto o estilo de código afeta apenas os blocos de código delimitados.
As duas definições são independentes, e isso é fácil de errar: um tema escuro com um estilo de código claro produz um cartão com um retângulo brilhante recortado no meio. Escolha o estilo de código depois do tema e confirme que os blocos delimitados assentam dentro do cartão em vez de lutarem contra ele.
Fixe o tema pelo nome nas suas notas ou no seu script em vez de confiar no que o editor usou da última vez. Um conjunto de cartões perde a coerência visual no momento em que uma imagem é renderizada com outra palete, e é precisamente esse tipo de desvio que passa despercebido até as imagens aparecerem lado a lado num feed.
Pré-visualize a imagem renderizada na largura real de exibição antes de publicar. Um cartão que parece bem num painel de pré-visualização pode tornar-se difícil de ler quando é reduzido no feed.
Divida uma publicação longa num fio de cartões, uma ideia por cartão. Cada cartão deve funcionar por si só, porque as pessoas verão os cartões fora de ordem.
Uma divisão prática é um cabeçalho, um ponto-chave e uma lista curta por cartão. Mantenha o mesmo tema e largura ao longo do fio para que os cartões pareçam um conjunto.
Resista à tentação de continuar uma frase entre dois cartões. Os fios são partilhados uma imagem de cada vez, e um cartão que começa a meio de uma ideia lê-se como avariado quando aparece sozinho. Se uma ideia precisa realmente de mais espaço do que um cartão permite, é sinal de que pertence ao artigo ligado.
Três a cinco cartões é um intervalo viável para a maioria dos fios. Acima disso, o leitor faz o trabalho de ler um artigo sem a vantagem de o poder percorrer, e as imagens deixam de justificar o lugar que ocupam.
O texto alternativo importa tanto para a acessibilidade como para a pesquisa. Descreva o que a imagem mostra, incluindo o texto que contém, sem repetir a legenda inteira.
Escreva o texto alternativo como se a imagem não estivesse lá. Se o cartão diz "Deployment complete — all checks passing", o texto alternativo para um público geral pode ser "Um cartão Markdown de tema escuro que mostra uma lista de implementação com dois passos concluídos e um pendente". Isso é mais útil do que "imagem de uma lista" e menos redundante do que copiar todo o Markdown palavra por palavra.
As plataformas limitam a quantidade de texto alternativo que pode adicionar. No X (Twitter), o campo de descrição de imagem aceita até 1000 caracteres por imagem. Este número baseia-se na documentação de ajuda pública do X; as páginas de ajuda não estavam legíveis por máquina a 3 de agosto de 2026, por isso confirme o limite atual antes de depender dele num modelo. A ajuda do LinkedIn não indica um limite separado de texto alternativo para publicações de imagem padrão.
Mantenha o texto alternativo mais curto do que o limite da plataforma permite. Uma descrição que preenche todo o orçamento de caracteres não é mais útil: é mais difícil de processar e corre o risco de ser truncada em algumas cadeias de tecnologia de apoio. Aponte para uma ou duas frases que digam ao leitor o que aprenderia com a imagem, e pare aí.
Quando renderiza muitas imagens, os mesmos parâmetros tornam-se um script. A Markdown to Image API aceita um pedido POST com um token Bearer e devolve um URL temporário que é mantido durante 24 horas em modo URL, ou dados de imagem em bruto em modo binário. Descarregue o resultado sem demora; o URL temporário não é armazenamento permanente.
Um pedido mínimo define a mesma largura, qualidade e tema que escolheu no editor:
{
"markdown": "# Weekly update\n\n- Faster exports\n- Clearer reports\n- One repeatable workflow",
"format": "png",
"width": 1200,
"quality": 2,
"theme": "github-dark",
"mode": "url"
}
O guia de integração completo cobre cURL, Node.js, Python e n8n: Markdown to Image API: Generate PNGs with cURL, Node.js, Python, and n8n.
- Pré-visualize a imagem na largura real de exibição.
- Confirme que a mensagem cabe num ecrã sem linhas cortadas.
- Verifique o contraste em temas claros e escuros.
- Adicione texto alternativo que descreva a imagem, não apenas a legenda.
- Confirme que o tema e a largura correspondem ao resto do conjunto.
- Verifique se a linha mais longa e qualquer tabela cabem sem aperto horizontal.
- Mantenha a fonte Markdown em controlo de versões.
- Reexporte quando o conteúdo mudar; não edite texto dentro de um mapa de bits.
O último ponto merece ser dito sem rodeios: a partir do momento em que corrige texto diretamente dentro de um PNG, a imagem e a sua fonte Markdown divergiram, e cada edição futura agrava o problema. Reexportar leva segundos e mantém a fonte como referência.
Qual é o melhor tamanho de imagem para redes sociais? Não existe um único melhor tamanho, mas uma tela de 1200 pixéis de largura é um valor por omissão prático: mantém-se nítida em ecrãs de alta densidade e conserva o comprimento de linha legível. Para uma publicação do LinkedIn com ligação, a plataforma recomenda uma proporção de 1,91:1 por volta de 1200 x 627 pixéis.
Posso transformar um artigo longo numa imagem? Pode, mas normalmente não deve. Divida-o num fio de cartões com uma ideia por cartão.
Quanto texto alternativo posso adicionar? No X (Twitter), o campo de descrição de imagem aceita até 1000 caracteres por imagem, segundo a documentação de ajuda pública do X. Confirme o limite atual antes de depender dele.
O MarkdownToImage tem API? Sim. A API aceita um pedido POST com um token Bearer e suporta saída PNG, JPEG, WebP ou PDF. Consulte a documentação da API e o guia de integração.
Como mantenho os cartões consistentes? Use o mesmo tema, estilo de código e largura em todo o conjunto, e mantenha a fonte Markdown em controlo de versões.
Orientações de plataforma verificadas a 3 de agosto de 2026: descrições de imagem do X e especificações de imagem personalizada do LinkedIn. Os parâmetros do MarkdownToImage correspondem à documentação da API.
As especificações de imagem das plataformas e os limites de texto alternativo mudam sem aviso. Volte a verificar as duas ligações de plataforma acima antes de fixar qualquer número concreto num modelo ou numa cadeia automatizada.
Transforme já uma fonte Markdown numa imagem pronta a publicar: abra o MarkdownToImage, cole a sua próxima atualização e exporte-a como cartão de 1200 pixéis de largura.