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.

Por qué acp2md

Una página autorizada, capturada con exactitud

Cuando una sola página tiene peso —una auditoría, una retención legal, un pico de migración, una fuente curada para RAG— acp2md la exporta con precisión desde un ID, un título o una URL pegada, con acceso de solo lectura y renderizado de macros compatibles, en Markdown limpio o payloads nativos que tú controlas.

Captura manual vs acp2md

Confluence no ofrece una forma rápida y repetible de extraer una sola página como Markdown gobernado. acp2md cubre esa carencia.

Precisión

Copiar y pegar, o exportar un espacio completo solo para una página.

Apunta a una página exacta por ID, título o URL.

Fidelidad

Capturas de pantalla o HTML con pérdidas y ruido de plataforma.

CommonMark/GFM limpio, o payloads nativos ADF/Storage.

Repetibilidad

Manual, puntual y fácil de equivocar bajo presión.

Automatizable, con estado de sync por página para reejecuciones limpias.

Acceso y seguridad

Acceso de edición amplio solo para hacer una copia.

Peticiones GET de solo lectura: seguras para evidencia, sin cambios.

Captura evidencia lista para auditoría de SOC 2, ISO 27001 o retención legal sin tocar Confluence: reproducible, de solo lectura y almacenada donde tú decidas.

Precio a medida del desarrollador, no un impuesto por usuario

Los exportadores del marketplace cobran por cada usuario de Confluence aunque solo una persona exporte páginas. acp2md se licencia por puestos de operador, así que un único desarrollador paga el precio de un único desarrollador.

Ilustrativo: la licencia por usuario sube con cada usuario de Confluence, mientras que el precio por puesto de operador se mantiene plano. Los precios reales varían; esto muestra la forma de cada modelo, no precios concretos de ningún proveedor.

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.