De Confluence a Obsidian

De Confluence a Obsidian

Exporta páginas y espacios completos de Confluence a bóvedas de Obsidian: callouts nativos, wikilinks, etiquetas a partir de labels, imágenes como archivos sidecar y una sincronización de solo cambios que mantiene la bóveda al día.

acp2md y acs2md leen Confluence Cloud a través de su API y escriben Markdown que Obsidian trata como propio. Un solo flag, --obsidian, activa todo el preajuste; el resto de funciones de conversión —macros, adjuntos, reescritura de enlaces, front matter— sigue disponible.

Qué hace el preajuste de Obsidian

Cada punto es una decisión de conversión que de otro modo tendrías que arreglar a mano en la bóveda.

Callouts nativos

Los paneles de información, nota, aviso, éxito y error de Confluence se convierten en callouts de Obsidian, así que un runbook se lee igual en ambos sitios. Sin el preajuste se renderizan como alerts de GitHub, que Obsidian también muestra.

Wikilinks entre páginas

Los enlaces a otras páginas de Confluence se convierten en [[wikilinks]] que la bóveda resuelve, y los enlaces a encabezados usan anclajes que Obsidian entiende en lugar de slugs al estilo de GitHub.

Labels como etiquetas

Las labels de Confluence se convierten en #tags en línea y en tags del front matter que Obsidian lee como Properties, así que el panel de etiquetas y la búsqueda indexan la bóveda desde el primer día.

Imágenes como archivos sidecar

Las imágenes se guardan junto a la nota bajo attachments/ y se enlazan de forma relativa en lugar de incrustarse en base64, que Obsidian no renderiza; una imagen reutilizada en varias páginas se guarda una sola vez.

Una bóveda que refleja el espacio

acs2md conserva el árbol de páginas como carpetas, reescribe los enlaces internos como enlaces relativos y convierte varias páginas a la vez, así que un espacio de mil páginas se convierte en una bóveda navegable en una sola ejecución.

Refresco de solo cambios

Vuelve a ejecutar la exportación con --sync y solo se reconvierten las páginas que cambiaron; las páginas eliminadas en Confluence salen de la bóveda, o se conservan con --incremental.

Qué herramienta para qué bóveda

Usa acp2md para llevar una página de Confluence a una bóveda existente como nota. Usa acs2md cuando la bóveda es el espacio.

Disponible ahora

acp2md

acp2md convierte una página por ID, título o URL pegada en una nota, con el preajuste de Obsidian aplicado.

  • Un comando: acp2md page convert by-id ID --obsidian -o ./vault/note.md
  • Elige el estilo de panel, los wikilinks, las etiquetas en línea y las dimensiones de medios por separado cuando el preajuste completo sea demasiado.
  • Cuenta nodos y marcas primero para ver en qué se convertirá una página compleja.

Disponible ahora

acs2md

acs2md exporta un espacio completo como una bóveda cuyas carpetas siguen el árbol de páginas, y después la mantiene sincronizada.

  • Un comando: acs2md space convert by-key KEY --obsidian --output-dir ./vault
  • Los enlaces internos se reescriben como enlaces relativos que la bóveda resuelve; cuatro páginas se convierten a la vez por defecto, al ritmo que marcan los límites de Confluence.
  • Vuelve a ejecutar con --sync para un refresco de solo cambios, y la bóveda sigue al espacio.

Por qué los equipos llevan Confluence a Obsidian

Obsidian da a un conjunto documental lo que una pestaña del navegador no puede: acceso sin conexión, búsqueda local, vista de grafo y archivos planos en Git.

Documentación del equipo como base de conocimiento personal

Trae a una sola bóveda los espacios con los que trabajas, enlázalos con tus propias notas y refréscalos con --sync sin rehacer tus enlaces.

Runbooks sin conexión

Los ingenieros de guardia abren procedimientos, diagramas y adjuntos desde la bóveda cuando lo que está caído es la red, o Confluence.

Migración fuera de Confluence

Exporta todo el patrimonio como bóveda, revisa qué se renderizó y qué quedó como comentario HTML, y decide qué conservar antes de que termine la suscripción.

Asistentes de IA locales

Una bóveda de Markdown limpio con front matter está lista para pipelines locales de embeddings y recuperación sin enviar una sola página a ningún sitio.

Elige la herramienta que encaja con tu bóveda

Una página o el espacio completo: ambas usan el mismo motor, el mismo preajuste y el mismo modelo de licencia.