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.

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 pagina origen
• la salida ya queda en Markdown lista para revisión y control de cambios

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 busqueda

Usa este flujo cuando necesitas una pagina de referencia en una forma mas ligera para pipelines de IA o de busqueda.

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 seleccion 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 aprobacion o una publicacion.

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

Por qué es útil:

• se conserva el estado previo a publicacion
• la revisión puede hacerse fuera de Confluence
• ayuda en procesos de aprobacion 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

Secuencia recomendada para una ejecución con cliente

1. confirmar el puesto con doctor
2. validar el alcance con space list y space pages
3. elegir la forma de entrada adecuada: ID, titulo o URL
4. decidir si la salida es para retencion, Git, analisis o IA
5. elegir de forma consciente --sync o --incremental cuando haya ejecuciones repetidas sobre archivo