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, esta pensado para operaciones documentales a gran escala: copias de continuidad, archivos de recuperacion, migraciones a Git, adopcion de docs-as-code, corpus repetibles preparados para IA y flujos compartidos de espacio y pagina desde un solo binario.

Desde 99,99 € · Facturación anual a través de Lemon Squeezy

$ 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, 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 y reescritura de enlaces

Preserva el árbol de páginas y reescribe los enlaces internos de Confluence como rutas relativas locales.

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 compartidos

Ejecuta page convert, get, count y properties desde el mismo binario cuando necesitas trabajo dirigido dentro de un flujo de exportación más amplio.

Listo para progreso y automatización

Usa barras de progreso en stderr y salidas estructuradas sin romper automatizaciones ni pipelines.

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 y recupera el contenido de la página en formato ADF.

3

Transforma

La herramienta convierte estructuras JSON de ADF complejas a Markdown CommonMark limpio y estándar.

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
  • 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, comandos de página, reescritura de enlaces, permisos o inventario de espacio.

Ver documentación