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
| Área | acp2md | acs2md |
|---|---|---|
| Alcance principal | Página única | Espacio completo |
| Caso de uso principal | Exportación y análisis preciso de una página | Exportación masiva y sincronización |
| Entradas habituales | ID de página, título de página, URL de Confluence | Clave de espacio, ID de espacio y comandos de página compartidos |
| Modelo de salida | Un 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 enlaces | No aplica a escala de documento | Reescribe enlaces de Confluence a rutas relativas locales |
| Encaje para continuidad | Runbooks, procedimientos y páginas críticas concretas | Copia completa de una base de conocimiento |
| Encaje para recuperación | Instantáneas de páginas de alto valor | Exportación orientada a recuperación de un espacio completo |
| Encaje para RAG | Documentos curados o conjuntos pequeños de páginas | Corpus grandes y pipelines repetibles de ingesta |
| Encaje para cumplimiento | Captura dirigida de evidencias e inspección de página | Inventario, gobernanza y soporte para revisiones de acceso a escala de espacio |
| Impacto en Confluence | Solo lectura - sin escrituras, sin modificaciones, sin eliminaciones | Solo lectura - sin escrituras, sin modificaciones, sin eliminaciones |
| Perfil comprador típico | Responsable de equipo, soporte, legal o analista de cumplimiento, ingeniero del conocimiento | Responsable 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_formatystoragepara inspección y resolución de problemas. - Incluyen comandos de configuración, licencia, diagnóstico y descubrimiento como
config,license,doctor,treeycompletion. - Usan exclusivamente solicitudes
GETde 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:
- validar el entorno con
doctor - descubrir el alcance correcto con
space listyspace pages - inspeccionar la superficie de comandos con
treeotree --short - confirmar el estado de licencia y configuración
- 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
acp2mdofrece control preciso sobre documentos individuales de alto valor.acs2mdofrece 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
acp2mdsi el requisito real es una sincronización continuada de todo un espacio. - No elijas
acs2mdsi 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 necesitaracs2md. - No olvides que
acs2mdahora incluye comandos de página; los flujos mixtos ya no obligan a cambiar de herramienta para cada inspección dirigida.
Escenarios de compra 🧩
Escenario: revisión legal o de cumplimiento
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
acp2mdcuando el requisito sea la precisión. - Usa
acs2mdcuando 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.