Convertendo um artigo HTML exportado em Markdown limpo no navegador com FormatArcConvertendo um artigo HTML exportado em Markdown limpo no navegador com FormatArc
Publicado: 2026-07-20

Migrar artigos entre Dev.to, Hashnode e Medium — o que cada exportação entrega

Toda plataforma de blogging aceita Markdown na entrada. Na saída, cada uma entrega algo diferente: o Dev.to mantém seus posts como Markdown, a exportação em massa do Hashnode é um arquivo JSON e o Medium devolve um ZIP de páginas HTML. A maioria dos guias de migração cobre um único salto — do Medium para o Hashnode, do Hashnode para um site estático. Este artigo é o mapa: o que cada plataforma entrega de verdade, como reconstruir o front matter no destino e o que fazer com as sobras de HTML.

Se você está saindo do Medium agora e só quer seus posts de volta como Markdown: o ZIP de exportação contém arquivos HTML, e você pode colar cada um em HTML para Markdown para obter Markdown limpo em segundos. A conversão roda inteiramente no seu navegador — nada é enviado. Para o panorama completo, continue lendo.

O que cada plataforma entrega na saída

PlataformaComo você obtém seus artigosO que você recebe
Dev.toOs posts são Markdown + front matter (guia do editorAbre em uma nova aba); baixe-os via API, por exemplo com um exportador da comunidadeAbre em uma nova abaMarkdown
HashnodeA exportação em massa do painel é JSON; cada artigo individual está disponível adicionando .md à URL (changelog oficialAbre em uma nova aba)JSON / Markdown
Medium"Download your informationAbre em uma nova aba" envia um ZIP com uma pasta posts/HTML (sem exportação para Markdown)
Qiita (Japão)A API v2Abre em uma nova aba devolve o Markdown (body) e o HTML (rendered_body) de cada postMarkdown + HTML
Zenn (Japão)Os artigos vivem como arquivos Markdown em um repositório do GitHub conectadoAbre em uma nova abaMarkdown

Comece pelo que você tem, não por aonde vai:

  • Você tem arquivos Markdown — pule para a reconstrução do front matter. O corpo costuma sobreviver como está.
  • Você tem JSON — extraia o campo Markdown de cada post (a exportação do Hashnode mantém o código-fonte dentro do JSON; ferramentas da comunidade como o hashnode-export-to-markdownAbre em uma nova aba dividem tudo em arquivos .md).
  • Você tem HTML — converta primeiro. Esse é o caso do Medium, tratado abaixo.

Tirar seus artigos do Dev.to

O Dev.to é a plataforma mais amigável para sair porque o editor é Markdown do início ao fim. Cada post carrega front matter no estilo Jekyll com title, published, tags, canonical_url, cover_image e series (guia do editorAbre em uma nova aba).

A rota prática de exportação é a API: gere uma chave de API nas configurações e baixe seus próprios artigos, que incluem o código-fonte Markdown. Scripts da comunidade como o Dev.to-exporterAbre em uma nova aba empacotam isso em um comando e salvam cada post como arquivo .md local. A partir daí, qualquer destino baseado em Markdown (o importador em massa do Hashnode, um gerador de sites estáticos, o Zenn) pode recebê-los com apenas ajustes de front matter.

Tirar seus artigos do Hashnode

O Hashnode oferece duas portas:

  • A exportação do painel baixa todos os posts como um único arquivo JSON. Ferramentas como o hashnode-export-to-markdownAbre em uma nova aba convertem esse JSON em arquivos Markdown individuais com front matter.
  • Desde junho de 2026, cada artigo também pode ser lido como Markdown puro adicionando .md à URL, ou solicitando a URL normal com o cabeçalho Accept: text/markdown (changelog oficialAbre em uma nova aba). Para poucos posts, é o caminho mais rápido — sem painel, sem conversor.

No sentido contrário, a página de importaçãoAbre em uma nova aba do Hashnode aceita um ZIP de arquivos .md pelo importador em massa de Markdown, o que a torna um destino conveniente para arquivos exportados de qualquer outro lugar.

Tirar seus artigos do Medium

O Medium é a plataforma que não fala Markdown na saída. "Download your informationAbre em uma nova aba" entrega um ZIP cuja pasta posts/ contém um arquivo HTML por história. Não há opção de Markdown, e não é garantido que embeds ou o layout de imagens sobrevivam intactos à conversão — planeje uma revisão.

Você tem duas formas de transformar esses arquivos HTML em Markdown:

<h2>Setup</h2>
<p>Execute <code>npm install</code> antes de tudo.</p>

sai assim:

## Setup

Execute `npm install` antes de tudo.

Como destino, o Medium ainda funciona: o recurso "Import a story" puxa um post de uma URL e define por você o link canônico para o original (descrito nesta análise de publicação cruzadaAbre em uma nova aba).

Reconstruir o front matter no destino

Corpos em Markdown viajam bem; metadados, não. Cada plataforma quer seu próprio cabeçalho. Para o Dev.to, um bloco mínimo de front matter fica assim (guia do editorAbre em uma nova aba):

---
title: "Meu post migrado"
published: true
tags: markdown, migration
canonical_url: "https://seublog.com/meu-post/"
cover_image: "https://seublog.com/images/capa.png"
---

Ao montar o front matter a partir de uma exportação, preserve três coisas no mínimo: o título, a data de publicação original (se o destino a aceitar) e a URL canônica. Todo o resto — tags, séries, imagens de capa — merece uma passada manual de qualquer forma, porque os vocabulários de tags raramente coincidem entre plataformas.

URLs canônicas: publicar em vários lugares sem dor de conteúdo duplicado

Se o mesmo artigo vive em duas plataformas, diga aos buscadores qual cópia é a original. O Dev.to tem o campo canonical_url no front matter (guia do editorAbre em uma nova aba); o Hashnode expõe uma configuração de URL do artigo original no fluxo de publicação e na API; a ferramenta de importação do Medium define o link canônico automaticamente ao importar de uma URL (ambos tratados nesta análiseAbre em uma nova aba). Escolha uma casa para cada artigo e aponte cada republicação para ela — a migração é o momento mais barato para resolver isso, porque você já está mexendo em cada post.

Imagens e blocos de código depois da mudança

Restam duas tarefas depois que o Markdown está no lugar:

  • As imagens dos posts exportados costumam continuar apontando para o CDN da plataforma antiga. O artigo renderiza hoje, mas os arquivos estão fora do seu controle. Baixe-os, envie-os de novo ao destino (ou ao seu próprio armazenamento) e reescreva as URLs.
  • Os blocos de código sobrevivem como blocos cercados, mas os dialetos de realce diferem entre plataformas. Antes de publicar, cole o Markdown convertido em Markdown para HTML para conferir a renderização no navegador — tabelas quebradas e blocos colapsados aparecem na hora.

Uma nota de segurança: arquivos de migração costumam conter posts não listados e rascunhos privados. Antes de passar um arquivo inteiro por um conversor que envia dados, vale ler como os conversores online lidam com seus dados. Ferramentas que rodam no navegador evitam a questão por completo. O mesmo fluxo se aplica à limpeza de exportações HTML do Notion.

Qiita e Zenn: as duas grandes plataformas de desenvolvedores do Japão

A cena japonesa de escrita para desenvolvedores roda principalmente no Qiita e no Zenn, e ambas são notavelmente amigáveis à migração. A API v2Abre em uma nova aba do Qiita devolve o código-fonte Markdown de cada post (body) junto do HTML renderizado (rendered_body). O Zenn gerencia artigos como arquivos Markdown simples em um repositório do GitHub, e seu front matter aceita um campo published_at que preserva as datas de publicação originais na migração — documentado no guia do Zenn CLIAbre em uma nova aba. Se o seu acervo inclui posts em japonês, vale o mesmo fluxo de quatro passos: exportar, normalizar a sintaxe, reconstruir o front matter, corrigir as imagens.

Perguntas frequentes

Qual é o jeito mais rápido de tirar um artigo de cada plataforma?

Dev.to: abra o post no editor e copie o Markdown. Hashnode: adicione .md à URL do artigo. Medium: peça o ZIP de exportação, ou copie o HTML da história e converta em HTML para Markdown.

O Dev.to tem exportação completa em um clique?

A rota confiável é a API: seus artigos, incluindo o código-fonte Markdown, ficam disponíveis com uma chave de API, e os exportadores da comunidade transformam isso em uma pasta de arquivos .md com um comando.

Vou perder minhas datas de publicação?

O Markdown em si não carrega datas — o front matter sim. Se o destino respeita a data original, depende da plataforma; o Zenn, por exemplo, aceita explicitamente datas retroativas via published_at para migrações (guia do Zenn CLIAbre em uma nova aba). Registre as datas originais da exportação antes de converter qualquer coisa.

É seguro passar todo o meu acervo por um conversor online?

Exportações incluem com frequência rascunhos e posts não listados. Prefira ferramentas que rodam localmente ou no navegador sem enviar dados — e veja nosso guia sobre a segurança dos conversores online para saber o que conferir antes de colar conteúdo sensível em qualquer lugar.

Fechamento

Uma migração de plataforma é, na verdade, uma migração de formatos: Markdown do Dev.to, JSON do Hashnode, HTML do Medium. Extraia o que a plataforma entrega, converta as sobras de HTML no navegador com HTML para Markdown, reconstrua o front matter para o destino, confira a renderização com Markdown para HTML e aproveite para definir as URLs canônicas. As duas ferramentas são gratuitas e nunca enviam seu conteúdo.