Skip to Content
Atlassian Confluenceacp2md vs acs2md

acp2md vs acs2md

Esta página explica la diferencia entre acp2md y acs2md desde dos perspectivas:

  • la perspectiva de ingeniería: qué hace cada herramienta, cómo se comporta y dónde encaja operativamente
  • la perspectiva de compra: por qué un equipo elegiría una herramienta, la otra o ambas juntas

Ambas herramientas convierten contenido de Atlassian Confluence a Markdown portable, pero están optimizadas para alcances de trabajo distintos.

Compatibilidad: tanto acp2md como acs2md son compatibles solo con Atlassian Confluence Cloud. Ninguna de las dos es compatible con Confluence Server ni Confluence Data Center.

Modelo de seguridad: ambas herramientas son de solo lectura por diseño y nunca modifican contenido de Confluence.

Posicionamiento: el valor no es solo conversión por CLI. El valor es control, propiedad y portabilidad del conocimiento empresarial a nivel de página con acp2md o a nivel de espacio con acs2md.


Resumen ejecutivo

acp2md es la herramienta focalizada a nivel de página.

  • Ideal para exportaciones precisas, inspecciones dirigidas, copia de seguridad de una sola página, resolución de problemas, análisis de migración y preparación RAG de un solo documento.
  • Útil cuando el equipo necesita trabajar a partir de un ID de página, un título o una URL de Confluence pegada.
  • Encaja muy bien con equipos legales, de soporte, cumplimiento, ingeniería del conocimiento y operaciones que a menudo necesitan una página exacta y no un espacio completo.

acs2md es la herramienta masiva a nivel de espacio.

  • Ideal para copias de seguridad de espacios completos, copias de continuidad, archivos de recuperación ante desastres, corpus RAG grandes, programas de migración y flujos repetibles de sincronización.
  • Preserva la jerarquía, reescribe enlaces internos y usa un archivo local de estado para descargar y reconvertir solo lo que ha cambiado.
  • Encaja muy bien con equipos de plataforma, responsables de documentación, operaciones IT, equipos de cumplimiento y organizaciones que necesitan exportaciones de espacios a escala.

Si la pregunta es “necesito una página o una operación muy dirigida”, elige acp2md.

Si la pregunta es “necesito toda una base de conocimiento o un flujo de sincronización continuado”, elige acs2md.

Si la organización necesita al mismo tiempo precisión dirigida y cobertura operativa masiva, usa ambas.

Si la petición empieza con “necesito una página exacta”, empieza por acp2md. Si empieza con “necesito todo el espacio”, empieza por acs2md.

Si el equipo aún no ha puesto en marcha las herramientas, empieza por la instalación y configuración inicial de acp2md o por la instalación y configuración inicial de acs2md antes de convertir la decisión en un flujo operativo.


Vista rápida

Áreaacp2mdacs2md
Alcance principalPágina únicaEspacio completo
Caso de uso principalExportación y análisis preciso de una páginaExportación masiva y sincronización
Entradas habitualesID de página, título de página, URL de ConfluenceClave de espacio, ID de espacio y comandos de página compartidos
Modelo de salidaUn archivo Markdown o una carga nativa de una páginaÁrbol completo de directorios Markdown con seguimiento de estado opcional
Modelo de sincronización.convert-sync-state.json para exportaciones repetidas de página.convert-sync-state.json a nivel de espacio para sincronización masiva solo de cambios
Reescritura de enlacesNo aplica a escala de documentoReescribe enlaces de Confluence a rutas relativas locales
Encaje para continuidadRunbooks, procedimientos y páginas críticas concretasCopia completa de una base de conocimiento
Encaje para recuperaciónInstantáneas de páginas de alto valorExportación orientada a recuperación de un espacio completo
Encaje para RAGDocumentos curados o conjuntos pequeños de páginasCorpus grandes y pipelines repetibles de ingesta
Encaje para cumplimientoCaptura dirigida de evidencias e inspección de páginaInventario, gobernanza y soporte para revisiones de acceso a escala de espacio
Impacto en ConfluenceSolo lectura - sin escrituras, sin modificaciones, sin eliminacionesSolo lectura - sin escrituras, sin modificaciones, sin eliminaciones
Perfil comprador típicoResponsable de equipo, soporte, legal o analista de cumplimiento, ingeniero del conocimientoResponsable de documentación, operaciones IT, propietario de plataforma, arquitecto empresarial

Capacidades compartidas

  • Convierten contenido de Confluence a Markdown en texto claro que el cliente puede poseer, revisar, guardar y administrar.
  • Dan soporte a la soberanía de datos moviendo el contenido a sistemas de almacenamiento y copia de seguridad controlados por el cliente.
  • Ayudan a los equipos a preparar contenido para RAG, búsqueda, ingesta LLM y automatización posterior.
  • Son compatibles con la recuperación nativa de Confluence en atlas_doc_format y storage para inspección y resolución de problemas.
  • Incluyen comandos de configuración, licencia, diagnóstico y descubrimiento como config, license, doctor, tree y completion.
  • Usan exclusivamente solicitudes GET de solo lectura. Ninguna de las dos crea, modifica ni elimina recursos de Confluence.
  • Encajan en entornos regulados donde importan la portabilidad, la auditabilidad y la retención.

En la práctica, ambas herramientas son compatibles con el mismo flujo seguro para operadores:

  1. validar el entorno con doctor
  2. descubrir el alcance correcto con space list y space pages
  3. inspeccionar la superficie de comandos con tree o tree --short
  4. confirmar el estado de licencia y configuración
  5. ejecutar el flujo dirigido de página o el flujo completo de espacio

acp2md en detalle

Qué es acp2md

acp2md es el especialista de página única.

Convierte, recupera, cuenta e inspecciona una sola página de Confluence cada vez. Eso lo hace especialmente útil cuando la organización necesita exactitud, rapidez de acceso y captura de evidencias dirigida.

Qué hace bien acp2md

  • Convierte una página a Markdown por ID, título o URL.
  • Recupera una página en formato nativo por ID, título o URL.
  • Cuenta nodos ADF y marcas de formato de una página por ID, título o URL.
  • Lista propiedades de página por ID, título o URL.
  • Lista espacios de Confluence accesibles para descubrimiento e inventario.
  • Explora páginas dentro de un espacio antes de elegir la página exacta.
  • Refresca con eficiencia una página exportada anteriormente con estado de sincronización por archivo.

Escenarios típicos de cliente para acp2md

  • Exportar una página de política para retención legal.
  • Llevar un runbook de producción a Git para revisión controlada.
  • Inspeccionar el ADF crudo de una página problemática durante pruebas de migración.
  • Analizar una página muy formateada antes de publicarla en un sitio estático.
  • Construir un pequeño conjunto RAG curado a partir de una selección de páginas autoritativas.

Valor para el cliente de acp2md

  • Un ingeniero de soporte puede pegar una URL de Confluence y obtener la página de inmediato.
  • Un analista de cumplimiento puede exportar una página de alto valor sin ejecutar un proceso masivo.
  • Un ingeniero del conocimiento puede inspeccionar la estructura de una página antes de decidir cómo fragmentarla o enriquecerla.
  • Un responsable de programa puede actualizar un runbook crítico para continuidad sin reexportar todo un espacio.

En resumen, acp2md es el instrumento de precisión.


acs2md en detalle

Qué es acs2md

acs2md es la herramienta a nivel de base de conocimiento.

Convierte y recupera contenido de Confluence a escala de espacio, mientras sigue exponiendo comandos de página para equipos que quieren un solo binario tanto para flujos dirigidos como masivos.

Qué hace bien acs2md

  • Convierte un espacio completo a Markdown por clave de espacio o ID de espacio.
  • Preserva la jerarquía como carpetas y archivos.
  • Reescribe enlaces internos de Confluence a enlaces Markdown relativos locales.
  • Mantiene un espacio sincronizado con eficiencia mediante .convert-sync-state.json.
  • Lista espacios, páginas, propiedades de espacio y permisos de espacio.
  • Da soporte a flujos de inventario, gobernanza y revisión de accesos a nivel de espacio.

Escenarios típicos de cliente para acs2md

  • Mantener una copia gobernada de continuidad de un espacio documental completo.
  • Construir un archivo de recuperación ante desastres fuera de la plataforma de origen.
  • Preparar una migración a sitio estático o a Git para una base de conocimiento.
  • Alimentar un pipeline grande de RAG o de búsqueda empresarial con una exportación repetible.
  • Auditar accesos y metadatos en un conjunto de espacios de una unidad de negocio.

Valor para el cliente de acs2md

  • El equipo evita volver a descargar contenido sin cambios durante ejecuciones recurrentes de sincronización.
  • Los datos generados son estructuralmente útiles como documentación, no solo un volcado de archivos desconectados.
  • Los enlaces internos siguen siendo navegables después de la exportación.
  • Las propiedades y permisos a nivel de espacio dan soporte a gobernanza, cumplimiento y revisiones de seguridad.
  • El seguimiento del progreso hace que los trabajos largos sean más seguros y fáciles de supervisar.

En resumen, acs2md es el flujo de plataforma.


Guía de decisión para el cliente

Elige acp2md cuando

  • Necesitas una página, no todo un espacio.
  • El punto de partida habitual es una URL de página pegada desde el navegador.
  • Equipos legales, de cumplimiento, soporte o ingeniería necesitan exportaciones dirigidas.
  • Quieres una herramienta de inspección a nivel de página para resolución de problemas o análisis de migración.
  • Quieres construir o mantener un conjunto curado de documentos Markdown de alto valor.

Elige acs2md cuando

  • Necesitas una copia de seguridad documental completa o una copia de continuidad.
  • Quieres una sincronización recurrente solo de cambios para todo un espacio.
  • Necesitas documentación portable con jerarquía preservada y enlaces internos reescritos.
  • Necesitas capacidades de inventario y auditoría a nivel de espacio.
  • Estás planificando una migración grande, un archivo de recuperación ante desastres o un programa de RAG.

Elige ambas cuando

  • Los equipos de operaciones necesitan un flujo masivo de plataforma y los equipos de soporte siguen necesitando acciones dirigidas de página.
  • Quieres un proceso de exportación a escala de espacio combinado con análisis puntual y resolución de problemas de páginas.
  • Estás construyendo un programa de documentación gestionada con casos de uso estratégicos y tácticos.

Perspectiva de compra

Para un comprador técnico

acp2md responde a la pregunta: “¿cómo hacemos portable, inspeccionable y reutilizable una sola página?”

acs2md responde a la pregunta: “¿cómo hacemos portable operativamente un espacio de Confluence a escala?”

Para un evaluador técnico, la diferencia es principalmente de alcance, gestión de estado y estructura de salida.

Para un responsable de documentación

acp2md es ideal para documentos curados y de alto valor informativo.

acs2md es ideal para patrimonios documentales, taxonomías y operaciones documentales repetibles.

Para un responsable de cumplimiento o gobernanza

acp2md es útil para páginas de evidencia concretas.

acs2md es más útil para informes de amplio alcance, preparación de revisiones de acceso, instantáneas de inventario y ejercicios de gobernanza a escala de espacio.

Para un responsable de IA o de plataforma de conocimiento

acp2md es útil para documentos fuente curados y autoritativos.

acs2md es útil para corpus amplios, repetibles y flujos de ingesta operativa.

Para un responsable de seguridad o revisión de accesos

acp2md ayuda a inspeccionar páginas concretas y sus propiedades.

acs2md añade la visibilidad de permisos y propiedades a nivel de espacio que importa cuando se revisa quién tiene acceso, cómo se gobierna un espacio y qué debe limpiarse antes de una migración o una auditoría.


Posicionamiento de negocio y comercial

Posición de acp2md

acp2md es la herramienta de exportación de precisión.

Es fácil de explicar a clientes que necesitan uno de estos resultados:

  • preservar una página crítica
  • inspeccionar o resolver problemas en una página
  • analizar una página antes de una migración
  • transformar un documento individual a Markdown para uso posterior

Posición de acs2md

acs2md es la plataforma operativa de exportación.

Es fácil de explicar a clientes que necesitan uno de estos resultados:

  • mantener un espacio completo respaldado o sincronizado
  • prepararse para una migración o recuperación ante desastres
  • construir un espejo documental en Git o almacenamiento de objetos
  • auditar metadatos y permisos del espacio
  • generar un corpus reutilizable en Markdown para IA y búsqueda

Mensaje comercial

  • acp2md ofrece control preciso sobre documentos individuales de alto valor.
  • acs2md ofrece control escalable sobre dominios documentales completos.
  • Ambas convierten el conocimiento de Confluence en Markdown controlado por el cliente, lo que mejora portabilidad, gobernanza, auditabilidad y reutilización.
  • Ambas comparten conceptos de descubrimiento, diagnóstico y licencia, lo que reduce el esfuerzo de formación para equipos que adopten las dos.

Errores comunes que conviene evitar ⚠️

  • No elijas acp2md si el requisito real es una sincronización continuada de todo un espacio.
  • No elijas acs2md si el requisito real es una exportación rápida de una sola página para soporte o cumplimiento.
  • No plantees la decisión como “herramienta pequeña vs herramienta seria”. Ambas son herramientas serias; simplemente resuelven alcances operativos distintos.
  • No asumas que el uso de IA implica una sola herramienta. Las fuentes curadas suelen empezar con acp2md, mientras que los corpus amplios suelen necesitar acs2md.
  • No olvides que acs2md ahora incluye comandos de página; los flujos mixtos ya no obligan a cambiar de herramienta para cada inspección dirigida.

Escenarios de compra 🧩

Necesidad: páginas de política seleccionadas, páginas de evidencia o documentos de control exactos.

Mejor opción: acp2md

Escenario: continuidad o recuperación ante desastres

Necesidad: una copia actualizada de un espacio completo de Confluence fuera de la plataforma de origen.

Mejor opción: acs2md

Escenario: programa de migración

Necesidad: inspeccionar primero unas pocas páginas complejas y después exportar toda la base de conocimiento.

Mejor opción: ambas

Escenario: despliegue de IA empresarial

Necesidad: crear un corpus Markdown de confianza para RAG o búsqueda.

Mejor opción: acp2md para fuentes curadas de referencia y acs2md para generación amplia y recurrente de corpus.

Escenario: comprador y equipo cliente a la vez

Necesidad: explicar el portafolio de forma simple tanto al comprador de negocio como al equipo técnico que lo operará.

Mejor opción: ambas, con la distinción planteada como precisión frente a escala.


Recomendación final ✅

  • Usa acp2md cuando el requisito sea la precisión.
  • Usa acs2md cuando el requisito sea la escala.
  • Usa ambas cuando tu estrategia de portabilidad de Confluence necesite operaciones exactas de página y flujos repetibles a escala de espacio.

Esa es la forma más clara de explicar las dos herramientas a clientes, equipos internos y futuros compradores.

Last updated on