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:acp2md
Exportación de espacio

acs2md

Confluence Space to Markdown para exportacion de espacios completos, sincronizacion, backup, migracion y preparacion de conocimiento para IA.

acs2md, abreviatura de Atlassian Confluence Space to Markdown, está pensado para operaciones documentales a gran escala en Confluence Cloud: copias de continuidad, archivos de recuperación, migraciones a Git, adopción de docs-as-code, corpus repetibles preparados para IA, renderizado de extensiones compatibles y flujos compartidos de espacio y página desde un solo binario de solo lectura.

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

$ acs2md space convert by-key DOCS --output-dir ./docs-export
→ Listando páginas en DOCS...
→ Sincronizando solo las páginas modificadas...
→ Reescribiendo enlaces internos...
✓ Exportado a ./docs-export
$_
Capacidades Poderosas

Características Principales

acs2md está pensado para exportación a escala de espacio, renderizado de macros compatibles, sincronización, gobernanza y reutilización repetible aguas abajo.

Conversión de espacio completo

Exporta un espacio entero de Confluence en una sola ejecución preservando la jerarquía como carpetas y archivos.

Jerarquía, enlaces y extensiones

Preserva el árbol de páginas como carpetas y archivos mientras reescribe enlaces internos de Confluence y renderiza macros, tarjetas y adjuntos compatibles en una salida portable.

Estado de sincronización eficiente

Usa .convert-sync-state.json para omitir páginas sin cambios y hacer prácticas las exportaciones recurrentes.

Inventario y permisos de espacio

Lista espacios, páginas, propiedades y permisos para gobernanza, auditorías y planificación de migraciones.

Comandos de página y conversión rica

Ejecuta page convert, get, count y properties desde el mismo binario mientras reutilizas el mismo motor de extensiones para Draw.io, TOC, Page Tree, Children, tarjetas inline y adjuntos.

Progreso, solo lectura y automatización

Usa barras de progreso en stderr y salida estructurada en trabajos largos mientras cada llamada a Confluence sigue siendo de solo lectura y segura para automatización gobernada.

Contenido compatible

Las exportaciones de espacio usan el mismo motor, así que conservan estructura y mantienen visibles los fallbacks.

Imágenes, medios y adjuntos

Lleva imágenes inline, medios de Confluence, PDFs, archivos de Office, comprimidos, diagramas Draw.io y salidas de Roadmap Planner con el árbol exportado.

Macros de navegación y descubrimiento

Renderiza Table of Contents, Page Tree, Children, Recently Updated, etiquetas y listados de blog como navegación Markdown en todo el espacio.

Macros de gobernanza y reporting

Resuelve Contributors, Task Report, Content Report Table, Page Signatures y macros QC durante la conversión masiva.

Tarjetas y fallbacks

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

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

acs2md 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, jerarquía, enlaces, tarjetas, adjuntos y extensiones compatibles en Markdown CommonMark limpio con salida preparada para sync.

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

acs2md

MMarkdown

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

Casos de Uso Ideales

Copias de continuidad

Mantiene una copia actual en Markdown de un espacio documental completo fuera de Confluence para resiliencia operativa.

Archivos de recuperación ante desastres

Construye archivos recuperables y controlados por el cliente que no dependan de la plataforma de origen para leer o almacenar la documentación.

Migración de documentación

Mueve un patrimonio completo de Confluence a flujos de documentación basados en Git preservando estructura y navegabilidad.

Generación de corpus para IA

Crea corpus Markdown repetibles para búsqueda empresarial, recuperación y asistentes de conocimiento.

Gobernanza y revisión de accesos

Inspecciona metadatos de espacio, inventario de páginas y permisos antes de auditorías, limpiezas o transiciones de plataforma.

Automatización de exportaciones recurrentes

Ejecuta exportaciones programadas de solo cambios en CI o automatizaciones internas y sigue usando comandos de página para trabajo de seguimiento dirigido.

Configuración Rápida

Empezar

1. Requisitos Previos

  • Una licencia válida de acs2md o una clave de prueba gratuita de 14 días
  • Acceso de lectura al espacio de Confluence objetivo
  • Un token API de Atlassian y un directorio de destino para la documentación exportada

2. Genera un Token de API

acs2md 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 acs2md-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 acs2md con variables de entorno específicas de la herramienta:

export ACS2MD_CONFLUENCE_DOMAIN="your-domain.atlassian.net"
export ACS2MD_CONFLUENCE_USERNAME="email@example.com"
export ACS2MD_CONFLUENCE_API_TOKEN="your-api-token"

4. Tu Primera Conversión

Convierte un espacio completo de Confluence a Markdown:

$ acs2md space convert by-key DOCS --output-dir ./docs-export

Sustituye DOCS por tu clave real de espacio de Confluence. Usa acs2md space list si necesitas descubrir los espacios disponibles.

5. Comandos Comunes

Convierte un espacio completo:

acs2md space convert by-key <SPACE_KEY> --output-dir ./docs

Lista los espacios disponibles:

acs2md space list

Inspecciona una página desde el mismo binario:

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

¿Necesitas Ayuda?

Usa la documentación detallada cuando necesites estrategia de sync, flags de extensiones, comandos de página, reescritura de enlaces, permisos o inventario de espacio.

Ver documentación

Empieza con un espacio de Confluence

Usa la guía de inicio para validar acceso, activar una prueba o licencia de pago y exportar un espacio completo de Confluence a Markdown portable.