Importación y exportación

Mover contenido hacia y desde Chinaski es un conjunto de herramientas concretas: un importador de Markdown para archivos con front matter, importación y exportación de JSON/CSV para contenido estructurado, creación masiva y una cola de trabajos asíncronos para operaciones muy grandes. Esta página recorre cada una en orden.

Importar archivos Markdown

Si tu contenido ya vive como archivos .md (de otro CMS, de un sitio estático o de una herramienta de escritura), la importación de Markdown lo trae como borradores editables:

Elige el tipo de contenido destino (páginas o posts) y el idioma, y sube hasta 100 archivos en un lote (tamaño total de hasta 40 MiB).
Cada archivo puede llevar un bloque YAML de front matter en la parte superior con título, slug, idioma, categoría y meta descripción. El front matter es opcional: cuando está ausente, el importador toma el título del primer H1 del documento (eliminándolo del cuerpo para evitar un heading duplicado) o, en su defecto, del nombre del archivo.
Todo se convierte a HTML en la importación, y cualquier H1 de nivel superior restante dentro del cuerpo se degrada a H2 para que la estructura de la página siga siendo válida en el sistema de headings del editor.
Todo se importa sin publicar: revisa la pantalla de resultados (lista el éxito/errores por archivo) y luego publica cuando estés satisfecho.
Las colisiones de slug se manejan automáticamente (my-page-2, etc.); los conflictos dentro del lote nunca se sobrescriben silenciosamente.
El front matter debe ser líneas planas de clave/valor: una lista anidada bajo title: se rechaza con un error específico que nombra el campo.
El front matter malformado hace fallar solo ese archivo; el resto del lote continúa.
Si al servidor le faltan los módulos opcionales del pipeline de Markdown, el formulario de importación te lo avisa antes de que selecciones archivos (un admin puede instalarlos).

Importaciones estructuradas (JSON)

Para una migración producida por máquina (desde una exportación, desde un script propio o desde la API), usa las importaciones JSON:

Cada área de contenido que puedes exportar (páginas, posts, categorías, nav, documentos, redirecciones, medios y más) acepta un archivo de arreglo de objetos con los campos de esa entidad.
Hasta 5,000 filas por importación y un archivo de 4 MiB.
Un paso de vista previa muestra los resultados por fila antes de que se escriba nada.
En la importación real puedes elegir actualizar los elementos existentes en lugar de solo crear nuevos: la clave es por entidad (páginas con clave slug+idioma, categorías con clave nombre+idioma y slug+idioma, etc.).
Las filas se validan contra los idiomas del site y tus propios permisos por idioma antes de la inserción.

Creación masiva desde una lista

Para crear rápidamente muchos elementos cortos (un lote de páginas simples), la pantalla de creación masiva acepta una lista pegada de títulos/contenido y los crea todos, con sufijos por colisión de slug aplicados de la misma manera que el importador de Markdown.

Exportar tu contenido

Campos completos, JSON o CSV: la lista de páginas y la lista de posts ofrecen cada una exportación JSON (el registro de contenido completo: cuerpo, campos SEO, programación, claves de traducción) y CSV; ambos se pueden filtrar por idioma y estado publicado/borrador, y los elementos individuales se pueden exportar solos.
Exportaciones auxiliares: categorías, navegación, metadatos de documentos, redirecciones y metadatos de medios tienen cada una su propia exportación; usuarios, el registro de auditoría y tu calendario de programación ofrecen descargas CSV y ics donde corresponde.
Los archivos CSV llevan una marca de orden de bytes UTF-8, así que se abren limpiamente en Excel.
Las exportaciones incluyen solo lo que tu cuenta puede administrar: los editores exportan su propio alcance de contenido.

Todas estas exportaciones describen metadatos y texto. Los archivos de medios, los archivos de documentos en sí y la base de datos completa están cubiertos por las copias de seguridad: ver Backup & Recovery.

Migrar de forma segura

Exporta desde la fuente antigua (JSON de una instancia previa de Chinaski o CSV de una hoja de cálculo).
Importa por la ruta correspondiente con la vista previa activada; lee los resultados por fila.
Ejecuta la importación real con actualización de existentes activada si lo estás reintentando después de corregir problemas.
Todo termina como contenido: las importaciones nunca borran nada, así que las filas rotas nunca pueden borrar lo que ya está allí; tú limpias manualmente.
Reconstruye el site después de una importación grande (las importaciones pueden dispararlo; los lotes muy grandes pueden ejecutarse como trabajos en segundo plano con seguimiento de progreso vía la API).

Para operaciones muy grandes

La API REST acepta trabajos por lotes: envía la lista de elementos y luego consulta el estado del trabajo (progreso, errores, resultados) en lugar de mantener un navegador abierto. El servidor MCP incluido expone esto como herramientas para trabajo por lotes asistido por IA.

Cómo luce la entrada y la salida

Todo cruza en el formato JSON propio de Chinaski (o CSV columnar); no hay importador de dialecto propietario al estilo WXR de WordPress: JSON entra, JSON sale, la misma forma en la exportación que en la importación. En la práctica: tu contenido nunca queda atrapado; saca el JSON, transfórmalo como quieras, tráelo de vuelta, o simplemente respalda la instancia completa.