Importação & Exportação

Mover conteúdo para dentro e para fora do Chinaski é um conjunto de ferramentas concretas: um importador de Markdown para arquivos com front matter, importação e exportação em JSON/CSV para conteúdo estruturado, criação em lote e uma fila de jobs assíncrona para operações muito grandes. Esta página percorre cada uma em sequência.

Importando arquivos Markdown

Se o seu conteúdo já vive como arquivos .md (de outro CMS, de um site estático ou de uma ferramenta de escrita), a importação de Markdown o traz como rascunhos editáveis:

Escolha o tipo de conteúdo alvo (páginas ou posts) e o idioma, então envie até 100 arquivos em um lote (tamanho total de até 40 MiB).
Cada arquivo pode carregar um bloco de front matter YAML no topo com título, slug, idioma, categoria e descrição meta. O front matter é opcional; quando ausente, o importador toma o título do primeiro H1 do documento (removendo-o do corpo para evitar um título duplicado) ou, na falta desse, do nome do arquivo.
Tudo converte para HTML na importação, e quaisquer H1s de nível superior remanescentes dentro do corpo são rebaixados para H2 para que a estrutura da página permaneça válida no sistema de títulos do editor.
Tudo é importado não publicado: revise a tela de resultados (ela lista sucessos/erros por arquivo) e publique quando estiver satisfeito.
Colisões de slug são tratadas automaticamente (my-page-2, etc.); conflitos dentro do lote nunca sobrescrevem silenciosamente.
O front matter precisa ser linhas planas de chave/valor: uma lista aninhada sob title: é rejeitada com um erro específico nomeando o campo.
Front matter malformado faz falhar apenas aquele arquivo; o resto do lote prossegue.
Se o servidor não tiver os módulos opcionais do pipeline de Markdown, o formulário de importação avisa antes de você selecionar arquivos (um administrador pode instalá-los).

Importações estruturadas (JSON)

Para uma migração produzida por máquina (de uma exportação, de um script personalizado ou da API), use importações JSON:

Cada área de conteúdo que você pode exportar (páginas, posts, categorias, navegação, documentos, redirecionamentos, mídia e mais) aceita um arquivo de array de objetos com os campos daquela entidade.
Até 5.000 linhas por importação e um arquivo de 4 MiB.
Um passo de preview mostra resultados por linha antes que qualquer coisa seja escrita.
Na importação real você pode escolher atualizar itens existentes em vez de apenas criar novos; o chaveamento é por entidade (páginas chaveadas por slug+idioma, categorias por nome+idioma e slug+idioma, etc.).
As linhas são validadas contra os idiomas do site e suas próprias permissões por idioma antes da inserção.

Criação em lote a partir de uma lista

Para criar rapidamente muitos itens curtos (um lote de páginas simples), a tela de criação em lote aceita uma lista colada de títulos/conteúdo e os cria todos, com sufixos de colisão de slug aplicados da mesma forma que o importador de Markdown.

Exportando o seu conteúdo

Campos completos, JSON ou CSV: a lista de páginas e a lista de posts oferecem cada uma exportação em JSON (o registro de conteúdo completo, corpo, campos de SEO, agendamento, chaves de tradução) e em CSV; ambas podem ser filtradas por idioma e por estado publicado/rascunho, e itens individuais podem ser exportados sozinhos.
Exportações auxiliares: categorias, navegação, metadados de documentos, redirecionamentos e metadados de mídia têm cada um sua própria exportação; usuários, o log de auditoria e o seu calendário de agendamento oferecem downloads em CSV e ics quando apropriado.
Os arquivos CSV carregam uma marca de ordem de bytes UTF-8, então abrem limpos no Excel.
As exportações incluem apenas o que a sua conta tem permissão de gerenciar; editores exportam seu próprio escopo de conteúdo.

Todas essas exportações descrevem metadados e texto. Os arquivos de mídia, os próprios arquivos de documentos e o banco de dados completo são cobertos pelos backups; veja Backup & Recovery.

Migrando com segurança

Exporte da fonte antiga (JSON de uma instância anterior do Chinaski ou CSV de uma planilha).
Importe pela rota correspondente com o preview habilitado; leia os resultados por linha.
Rode a importação real com atualização-de-existentes habilitado se você estiver executando de novo após corrigir problemas.
Tudo acaba como conteúdo: importações nunca deletam nada, então linhas quebradas nunca podem apagar o que já está lá; você limpa manualmente.
Reconstrua o site após uma importação grande (importações podem dispará-lo; lotes muito grandes podem rodar como jobs em segundo plano com acompanhamento de progresso pela API).

Para operações muito grandes

A API REST aceita jobs em lote: submeta a lista de itens e depois faça polling do status do job (progresso, erros, resultados) em vez de manter um navegador aberto. O servidor MCP incluído expõe esses recursos como ferramentas para trabalho em lote assistido por IA.

Como é entrar e sair

Tudo cruza no formato JSON próprio do Chinaski (ou CSV colunar); não há importador de dialeto proprietário/WXR ao estilo WordPress: JSON entra, JSON sai, o mesmo formato na exportação que na importação. Na prática: seu conteúdo nunca fica preso; leve o JSON para fora, transforme-o como quiser, traga-o de volta, ou simplesmente faça backup da instância inteira.