Flujos y comandos

Esta página reúne flujos operativos de acp2md para clientes que ya conocen el producto y ahora necesitan aplicarlo de forma repetible en situaciones reales.

Si todavía no has completado la configuración inicial, empieza por Instalación y configuración inicial. Vuelve aquí cuando el puesto, la licencia y el acceso a Confluence ya estén validados.

Exportación controlada para retención o evidencia

Usa este patrón cuando un equipo legal, de cumplimiento o de gestión documental necesita capturar una página exacta en un formato duradero.


acp2md page convert by-id 123456 \
  --include-metadata \
  --output retention/policy-123456.md

Por qué es útil:

permite retener una sola página sin exportar un espacio completo
los metadatos conservan identificadores y contexto de versión
el resultado puede ir a Git, a una bóveda documental o a un archivo de evidencias

Llevar un runbook a Git

Usa este flujo cuando operaciones o soporte quieren trabajar con un runbook dentro del flujo habitual de repositorio.


acp2md page convert by-url "https://mycompany.atlassian.net/wiki/spaces/OPS/pages/123456/Runbook" \
  --output docs/runbooks/service-runbook.md \
  --sync

Por qué es útil:

la URL es cómoda cuando el punto de partida es un enlace compartido
--sync mantiene la copia alineada con la página de origen
la salida ya queda en Markdown lista para revisión y control de cambios

Exportación recurrente de página con retención orientada a archivo

Usa este flujo cuando un equipo necesita refrescar una página de alto valor con el tiempo pero conservar la última copia local incluso si la página origen desaparece después de Confluence.


acp2md page convert by-id 123456 \
  --output archive/policy-123456.md \
  --incremental

Por qué es útil:

el archivo local .convert-sync-state.json permite que las ejecuciones repetidas refresquen solo cuando la página cambia
--incremental conserva el archivo local si la página origen desaparece más adelante
el resultado se comporta más como un archivo controlado que como un espejo vivo estricto

Analizar una página compleja antes de migrar

Usa este flujo cuando el equipo necesita entender con precisión qué hay dentro de una página muy formateada antes de una migración.


acp2md page get by-id 123456 -f atlas_doc_format > analysis/page-123456-adf.json
acp2md page count nodes by-id 123456 > analysis/page-123456-nodes.json
acp2md page count marks by-id 123456 > analysis/page-123456-marks.json

Por qué es útil:

la salida ADF muestra la estructura nativa de la página
el recuento de nodos y marcas ayuda a medir complejidad
permite decidir pronto si hace falta una regla de migración específica

Preparar una fuente curada para RAG o búsqueda

Usa este flujo cuando necesitas una página de referencia en una forma más ligera para pipelines de IA o de búsqueda.


acp2md page convert by-id 123456 \
  --exclude-marks \
  --embed-images=false \
  --output rag/customer-policy.md

Por qué es útil:

la salida orientada a texto es más fácil de fragmentar e indexar
las imágenes externas reducen el tamaño final del archivo
una selección curada suele dar mejores resultados que un volcado amplio

Capturar un borrador antes de publicarlo

Usa este flujo cuando hace falta conservar una copia puntual del borrador antes de una aprobación o una publicación.


acp2md page convert by-id 123456 \
  --get-draft \
  --output archive/draft-123456.md

Por qué es útil:

se conserva el estado previo a la publicación
la revisión puede hacerse fuera de Confluence
ayuda en procesos de aprobación o de control documental

Flujo de diagnóstico para soporte

Usa este flujo cuando una ejecución falla y hay que escalar el caso con pruebas suficientes.


acp2md doctor
acp2md support --output support/acp2md-support.zip

Por qué es útil:

doctor ofrece el resumen más rápido del estado del puesto
el paquete de soporte reúne entorno, configuración, diagnósticos y variables enmascaradas
la escalación empieza con datos útiles en lugar de con suposiciones

Copia de seguridad de una página crítica y su restauración

Usa esto para runbooks, políticas u otras páginas que deban poder recuperarse dentro del propio Confluence. Disponible desde v1.0.12.


# Haz una copia de seguridad de la página con sus adjuntos
acp2md page get by-id PAGE_ID -o ./backups/runbook.json --attachments-dir ./backups/attachments
 
# Más adelante: ¿Confluence la sigue teniendo tal como se respaldó?
acp2md page check --file ./backups/runbook.json --attachments-dir ./backups/attachments
 
# Se eliminó o se sobrescribió: revisa el plan y después restaura
acp2md page restore --file ./backups/runbook.json --attachments-dir ./backups/attachments --dry-run
acp2md page restore --file ./backups/runbook.json --attachments-dir ./backups/attachments

Por qué es útil:

la copia de seguridad contiene el cuerpo, el título, el padre, la versión, las etiquetas y los archivos adjuntos
page check indica exactamente qué difiere antes de escribir nada
page restore revierte una página editada a su versión respaldada, conservando su historial, o recrea una eliminada

Evidencia para el plan de continuidad de negocio

Úsalo para el puñado de páginas que un plan de continuidad nombra explícitamente —el runbook de incidentes, el procedimiento de recuperación, la lista de contactos— cuando el plan tiene que demostrar que están respaldadas, al día y son restaurables (A.8.13 y A.5.30 de ISO/IEC 27001:2022, A1.3 de SOC 2, artículo 21(2)(c) de NIS 2, cláusula 7.5.3 de ISO 9001:2015). Climakers no está certificado bajo estos marcos; los archivos son la evidencia que presentas.


# 1. Respalda cada página nombrada con sus adjuntos
acp2md page get by-id PAGE_ID -o ./bcp/runbook.json --attachments-dir ./bcp/attachments
 
# 2. Verifica de forma programada y conserva el resultado
acp2md page check --file ./bcp/runbook.json --attachments-dir ./bcp/attachments --fail-on-drift -f json > ./bcp/runbook.check.json
 
# 3. Prueba la recuperación en un espacio de archivo sin tocar el original
acp2md page restore --file ./bcp/runbook.json --attachments-dir ./bcp/attachments --space-key BCPTEST --title "Runbook (prueba de recuperación)" --yes
 
# 4. Conserva una copia legible donde la gente pueda abrirla sin Confluence
acp2md page convert by-id PAGE_ID -o ./continuity/runbook.md --include-metadata

el resultado JSON de la comprobación nombra lo que difiere —estado, versión, cuerpo, adjuntos, etiquetas— y la salida distinta de cero es la alerta
la prueba de recuperación demuestra que la copia se restaura, con adjuntos, en una página que la gente puede abrir; retira después la página de prueba en Confluence, porque la restauración nunca elimina
para un espacio completo, usa acs2md: Evidencia para el plan de continuidad de negocio

Secuencia recomendada para una ejecución con cliente

confirmar el puesto con doctor
validar el alcance con space list y space pages
elegir la forma de entrada adecuada: ID, título o URL
decidir si la salida es para retención, Git, análisis o IA
elegir de forma consciente --sync o --incremental cuando haya ejecuciones repetidas sobre archivo

Mantén el alcance pequeño de forma deliberada. acp2md aporta más valor cuando la necesidad es precisión, trazabilidad y una página exacta, no una exportación a escala de patrimonio documental.