Importar desde Notion

Subí el export "Markdown & CSV" de tu workspace de Notion. Los databases con columna Status se convierten en Proyectos con tareas; el resto de las páginas .md va al Wiki de tu organización respetando la jerarquía de carpetas.

Cómo exportar desde Notion

  1. En Notion, abrí el workspace o el espacio que querés migrar.
  2. Clic en el menú · · · arriba a la derecha → Export.
  3. En el diálogo de export:
    • Export format: Markdown & CSV (no HTML, no PDF).
    • Include content: Everything.
    • Include subpages: activado.
    • Create folders for subpages: activado (esto es lo que preserva la jerarquía).
  4. Esperá que termine (Notion envía el link por email si es grande).
  5. Descargá el ZIP. No lo descomprimas — Orkestra lo consume tal cual.

El ZIP no debe superar 50 MB. Si tu workspace es más grande, exportá por sección (cada database o grupo de páginas por separado) y hacé múltiples imports.

Qué se importa

Databases → Proyectos

  • Cada .csv que tenga una columna llamada Status (o State) se convierte en un Project de Orkestra.
  • Los valores únicos de esa columna se convierten en WorkflowStates. Los que coincidan con Done, Completed, Closed, Resolved o Shipped (case-insensitive) quedan marcados como completados.
  • Cada fila del CSV se convierte en una Task. Título = columna Name o Title. Prioridad = columna Priority (Low/Medium/High/Urgent).
  • El resto de las columnas del CSV se guardan en la descripción de la task como bloques **Columna: valor**. No se crean custom fields (los campos nativos de Notion no tienen un match 1:1 con los de Orkestra).
  • El ID de la fila (notion_id, Notion ID, ID) se guarda en custom field notion_id. Si el CSV no trae un ID, se usa el título como fallback.

Páginas .md → Wiki

  • Todos los .md que no están dentro del folder de un database se convierten en páginas del Wiki (scope ORGANIZATION, visibilidad PUBLIC).
  • La jerarquía de carpetas se preserva como relaciones padre-hijo en el árbol wiki.
  • Notion agrega un hash hexadecimal al final de cada archivo/carpeta (ej. My Page 32a4b5c6d7e8.md). Orkestra lo extrae del título visible y lo conserva como custom field notion_id.
  • Links internos [texto](Page%20Name%20abc123.md) se reescriben a /wiki/<slug> si la página destino fue importada. Los links rotos se convierten a texto plano y se cuentan en la preview.

Qué queda fuera de scope

  • Databases sin columna Status/State — se ignoran con un warning. Si querés migrar un database sin Status, agregale una columna Status temporal antes de exportar, o usá el importer de CSV genérico.
  • CSVs con más de 1.000 filas — se truncan al tope con warning. Si tenés databases más grandes, dividilos antes.
  • Callouts, toggles, sync blocks, embeds de Notion — se preservan como texto/markdown tal cual vienen del export. No se renderizan como bloques especiales en Orkestra.
  • Imágenes incrustadas — quedan como referencias markdown a rutas relativas del ZIP. No subimos los binarios. Si querés preservarlas, subilas a mano a las páginas o tareas.
  • Relaciones entre databases (Relation properties, Rollups) — se ignoran silenciosamente.
  • Views / filtros / sorts de Notion — no se migran. Vas a reconstruirlos en Orkestra con Saved Views.
  • Templates de Notion — no se importan.
  • Assignees — la columna Assignee / Owner del CSV se detecta pero no se usa para asignar tareas. Notion no expone emails consistentes en los exports, por eso Orkestra no intenta mapear.
  • Comments, discussions, mentions — no están en el export de Notion.
  • Properties no estándar (Formula, Created by, Last edited, Select multi, Date range) — se guardan como texto en la descripción de la task, no como custom fields tipados.
  • Workspace settings, permisos, teamspaces — fuera de scope.

Requisitos

  • El import requiere una organización activa (scope=ORGANIZATION). No se puede importar a un espacio personal.
  • Necesitás permisos de admin o de creador de proyectos/wiki en la org.

Warnings vs ignores silenciosos

La preview avisa por: CSVs sin columna Status (skipped), CSVs > 1.000 filas (truncados), archivos no-markdown inesperados. Todo lo demás de "fuera de scope" se ignora sin mensaje.

Pasos en Orkestra

  1. Ir a Ajustes → Importar → Notion.
  2. Subir el ZIP del export.
  3. Revisar en la preview: cantidad de projects a crear, wiki pages, links rotos, filas truncadas.
  4. Ejecutar. El commit es atómico.

Recursos