Grupo padre

Atlassian Confluence

Herramientas CLI de Confluence a Markdown operadas por el cliente para exportacion de paginas, exportacion de espacios completos, migracion, continuidad, gobernanza, docs-as-code y flujos Markdown preparados para IA.

Herramienta relacionada dentro de este grupo:acs2md
Exportación de página

acp2md

Confluence Page to Markdown para exportacion exacta de paginas, snapshots de backup, evidencia de cumplimiento y preparacion de contenido para IA.

acp2md, abreviatura de Atlassian Confluence Page to Markdown, está pensado para operaciones precisas a nivel de página en Confluence Cloud: exportaciones controladas, backup de página, captura de evidencias, análisis de migración, traspaso a docs-as-code, preparación documental para IA y renderizado de extensiones compatibles desde el mismo binario de solo lectura.

Prueba gratuita de 14 días, planes de pago desde 19,99 €

$ acp2md page convert by-id 123456 -o ./page.md
→ Recuperando metadatos de la página...
→ Descargando la carga ADF...
→ Generando la salida Markdown...
✓ Exportado a ./page.md
$_
Capacidades Poderosas

Características Principales

acp2md está pensado para exportación precisa de páginas, recuperación nativa, renderizado de macros compatibles y uso controlado aguas abajo.

Entrada por ID, título o URL

Exporta exactamente la página que necesitas usando el identificador que tu equipo ya tiene.

Recuperación nativa y formatos en bruto

Obtén ADF o Storage para depuración, ingeniería de migración, análisis de páginas y procesamiento personalizado.

Estado de sincronización por página

Utiliza el archivo local .convert-sync-state.json para refrescar exportaciones recurrentes sin reprocesar páginas sin cambios.

Propiedades y análisis de página

Cuenta nodos y marcas, inspecciona propiedades y entiende una página antes de migrar, publicar o alimentar IA.

Extensiones y macros compatibles

Renderiza Table of Contents, Page Tree, Children, tarjetas inline, adjuntos, Draw.io, Roadmap Planner y otro contenido compatible de Confluence con fallbacks seguros.

Solo lectura, IA, auditoría y retención

Cada comando usa peticiones GET de solo lectura, para preparar documentos autoritativos para RAG, búsqueda interna, auditoría, retención legal y continuidad sin cambiar Confluence.

Contenido compatible

El contenido común de Confluence se renderiza directamente, las extensiones con API se resuelven con credenciales y los fallbacks siguen siendo visibles.

Imágenes, medios y adjuntos

Incrusta o enlaza imágenes inline, medios de Confluence, PDFs, archivos de Office, comprimidos, diagramas Draw.io y salidas de Roadmap Planner.

Macros de navegación y descubrimiento

Renderiza Table of Contents, Page Tree, Children, Recently Updated, etiquetas y listados de blog como anclas, listas y enlaces Markdown.

Macros de gobernanza y reporting

Resuelve Contributors, Task Report, Content Report Table, Page Signatures y macros QC como tablas legibles o valores inline.

Tarjetas y fallbacks

Resuelve tarjetas inline, embed y block cuando es posible; conserva las macros no disponibles como comentarios HTML.

Consulta la referencia para flags y valores por defecto. Las extensiones con API necesitan credenciales y contexto de página o espacio.

Simple y Confiable

Cómo Funciona

1

Autentica

Proporciona tu token de API de Atlassian de forma segura a través de variables de entorno.

2

Obtén Contenido

acp2md consulta la API de Confluence Cloud en modo de solo lectura y recupera el contenido de la página en formato ADF.

3

Transforma

La herramienta convierte ADF, tarjetas, adjuntos y extensiones compatibles en Markdown CommonMark limpio o payloads nativos con fallbacks elegantes.

4

Exporta

Guarda tus archivos Markdown localmente, haz commit en Git o intégralos en tu flujo de trabajo.

Resumen de conversión de formato

CConfluence

  • Basado en navegador
  • Formato ADF (JSON)
  • Acceso protegido
  • Difícil de versionar

acp2md

MMarkdown

  • Texto plano
  • CommonMark/GFM
  • Amigable con Git
  • Estándar universal
Aplicaciones en el Mundo Real

Casos de Uso Ideales

Evidencia para auditoría y legal

Crea instantáneas controladas de páginas de alto valor para auditoría, preparación de legal hold o retención regulada.

Runbooks y continuidad

Exporta runbooks operativos críticos a Markdown bajo control del cliente para continuidad y copias de seguridad.

Diseño de migración

Inspecciona una página compleja antes de una migración más amplia para entender macros, formato y casos límite.

Copia de seguridad de página

Preserva copias exactas de páginas sensibles o estratégicas antes de ediciones, limpiezas o cambios de plataforma.

Curación de fuentes para RAG

Prepara documentos únicos y autoritativos para fragmentación, embeddings y flujos de recuperación.

Soporte y respuesta a incidentes

Trabaja directamente desde una URL pegada cuando el equipo de soporte o incidentes necesita una página exacta de inmediato.

Configuración Rápida

Empezar

1. Requisitos Previos

  • Una licencia válida de acp2md o una clave de prueba gratuita de 14 días
  • Un dominio de Confluence Cloud y un usuario con acceso a la página objetivo
  • Un token API de Atlassian y una terminal en macOS o Linux. El soporte para Windows sigue en desarrollo.

2. Genera un Token de API

acp2md utiliza tokens de API de Atlassian para autenticación segura:

  1. Visita Cuenta de Atlassian
  2. Haz clic en Crear Token de API
  3. Etiquétalo como acp2md-cli
  4. Copia el token inmediatamente (no lo verás de nuevo)

Consejo de Seguridad: Nunca hardcodes tu token. Usa variables de entorno o un gestor de secretos.

3. Establece Variables de Entorno

Configura acp2md con variables de entorno específicas de la herramienta:

export ACP2MD_CONFLUENCE_DOMAIN="your-domain.atlassian.net"
export ACP2MD_CONFLUENCE_USERNAME="email@example.com"
export ACP2MD_CONFLUENCE_API_TOKEN="your-api-token"

4. Tu Primera Conversión

Convierte una página de Confluence a Markdown y guárdala en un archivo local:

$ acp2md page convert by-id 123456 -o ./page.md

Reemplaza 123456 con tu ID real de página de Confluence. También puedes usar un título o una URL pegada.

5. Comandos Comunes

Convierte una página por ID:

acp2md page convert by-id <PAGE_ID> -o ./docs/page.md

Convierte una página por URL:

acp2md page convert by-url "https://your-domain.atlassian.net/wiki/..." -o ./docs/page.md

Recupera ADF nativo para depuración o análisis de migración:

acp2md page get by-id <PAGE_ID> -f atlas_doc_format > ./docs/page.json

¿Necesitas Ayuda?

Usa la referencia detallada de comandos cuando necesites control de salida, flags de extensiones, comportamiento de sync, recuperación nativa o análisis de páginas.

Ver documentación

Empieza con una página de Confluence

Usa la guía de inicio para validar acceso, activar una prueba o licencia de pago y exportar exactamente la página que necesitas.