Utilidades
Esta página documenta los comandos de nivel superior que acs2md tree expone actualmente, además de los comandos de utilidad usados para diagnóstico y descubrimiento.
Estos comandos enmarcan el flujo operativo seguro para una exportación masiva: validar la estación de trabajo, inspeccionar la superficie de comandos y confirmar el objetivo antes de ejecutar una tarea con impacto.
Comandos de nivel superior
config— gestiona la configuración de la aplicación. Consulta Comandos de configuración.completion— genera scripts de autocompletado para shells compatibles. Se documenta más abajo.doctor— verifica configuración, credenciales y conectividad. Se documenta más abajo.license— gestiona tu licencia. Consulta Licencia.page— trabaja con páginas individuales de Confluence. Estos comandos a nivel de página se comportan como sus equivalentes en acp2md. Consulta Convertir páginas, Recuperar páginas, Conteo y análisis y Propiedades de página.space— trabaja con espacios de Confluence. Consulta Convertir espacios, Recuperar contenido del espacio, Listar espacios, Listar páginas, Propiedades del espacio y Permisos del espacio.support— genera un paquete de diagnóstico para compartir con soporte. Se documenta más abajo.tree— muestra el árbol completo de comandos con descripciones. Se documenta más abajo.
Doctor
acs2md doctor [flags]Ejecuta una serie de comprobaciones de diagnóstico y muestra los resultados. Úsalo para verificar la instalación antes de ejecutar una conversión.
Comprobaciones realizadas
| Comprobación | Descripción |
|---|---|
| Config | Verifica que exista un archivo de configuración y que sea válido |
| Credentials | Confirma que el dominio de Confluence, el usuario y el API token estén definidos |
| Conectividad API | Prueba una conexión real con la API REST de Confluence |
| Archivo de licencia | Verifica que exista una licencia vinculada a la máquina |
| Validación de licencia | Confirma que la licencia actual esté activa y sea utilizable |
| ID de máquina | Verifica que se pueda generar un identificador de máquina estable |
| Versión | Muestra la versión actual de acs2md, la fecha de compilación y el commit |
Ejemplos
# Ejecuta todas las comprobaciones de diagnóstico
acs2md doctor
# Los aliases funcionan igual
acs2md check
acs2md diagSalida de ejemplo de una ejecución real en macOS, con datos anonimizados:
🩺 Running diagnostics for acs2md v1.0.0...
✅ Configuration file /Users/<user>/Library/Application Support/acs2md/config.yaml
✅ Confluence credentials <tenant>.atlassian.net (user: <redacted>)
✅ Confluence API connected (310ms)
✅ License file loaded (<redacted>)
✅ License validation active (<redacted>)
✅ Machine ID <redacted>
✅ Versión acs2md v1.0.0 (darwin/arm64, built 2026-03-29T08:23:49Z)
📊 Result: all 7 checks passed
🎉 acs2md is ready to use!Momentos recomendados para ejecutar doctor:
- inmediatamente después de activar la licencia
- después de cambiar credenciales o configuración de proxy
- antes de la primera exportación masiva en una máquina nueva
- antes de una exportación programada o visible para clientes
En v1.0.0, doctor no tiene flags específicos del subcomando. Usa el flag global --no-progress cuando necesites una salida más limpia en CI o en grabaciones.
Cuando necesites todos los metadatos de compilación fuera del diagnóstico, ejecuta acs2md --version-extended.
completion
acs2md completion [bash|zsh|fish|powershell]Genera scripts de autocompletado para que los operadores recorran más rápido una superficie de comandos amplia.
powershell aquí se refiere solo a la generación del script de autocompletado. No implica que exista actualmente una versión para Windows.
Ejemplos
acs2md completion zsh
acs2md completion bash
acs2md completion fishEl autocompletado es especialmente útil para equipos que usan con frecuencia subcomandos space y page y quieren descubrir opciones más rápido desde el shell.
support
acs2md support [flags]Genera un paquete de diagnóstico para compartir con el equipo de soporte.
El comando support recopila información del sistema, configuración, comprobaciones diagnósticas, variables de entorno y salida reciente del log en un único archivo. Las credenciales presentes en la configuración y en las variables de entorno se anonimizan automáticamente. El contenido del log se incluye tal cual, así que conviene revisarlo brevemente antes de compartirlo si tu configuración de logging puede capturar datos sensibles.
Flags
| Flag | Short | Predeterminado | Descripción |
|---|---|---|---|
--output | -o | stdout | Escribe el paquete en un archivo en lugar de stdout |
--log-file | -l | desde config | Ruta del archivo de log que se incluirá en el paquete |
--log-lines | 50 | Número de líneas recientes del log que se incluirán |
Contenido del paquete
- Información del sistema: versión de la app, versión de Go, SO/arquitectura, commit y fecha de compilación
- Configuración: ruta del archivo de config, dominio y tipo de Confluence, ajustes HTTP y de log, con el token API anonimizado
- Diagnóstico: las mismas comprobaciones que
doctor - Entorno: solo variables
ACS2MD_*, con secretos anonimizados - Log reciente: las últimas N líneas del archivo seleccionado
Ejemplos
# Imprimir el paquete por stdout
acs2md support
# Guardar el paquete en un archivo
acs2md support --output bundle.txt
# Incluir más contexto del log
acs2md support --log-file app.log --log-lines 200Consejo: reproduce primero el problema con logging en modo debug y después genera el paquete:
# 1. Reproducir el problema con debug
acs2md space convert by-key MYSPACE --output-dir output --debug --log-file app.log
# 2. Generar el paquete de soporte
acs2md support --log-file app.log --output bundle.txtUsa support cuando necesites un único artefacto compartible que ya incluya el contexto más relevante de entorno, configuración y diagnóstico.
Tree
acs2md tree [flags]Imprime el árbol completo de comandos con descripciones. Es útil para descubrir los comandos disponibles y su jerarquía.
Flags
| Flag | Short | Predeterminado | Descripción |
|---|---|---|---|
--short | -s | false | Oculta los flags y muestra solo los comandos con descripción |
Ejemplos
# Muestra el árbol completo de comandos
acs2md tree
# Oculta los flags y muestra solo los comandos
acs2md tree --shortSalida de tree --short
La forma corta muestra comandos y descripciones sin flags — útil para runbooks de operadores y onboarding:
acs2md → Convert Atlassian Confluence spaces to Markdown
├── config → Manage application configuration
│ ├── create → Create the default configuration file
│ ├── get → Get a configuration value by key
│ ├── list → List all configuration values
│ ├── set → Set a configuration value
│ └── where → Show the location of the configuration file
├── doctor → Verify configuration, credentials, and connectivity
├── license → Manage your license
│ ├── activate → Activate a license for the application
│ ├── deactivate → Deactivate the license for this instance
│ ├── export → Export the license file to a backup location
│ ├── import → Import a license file from a backup
│ ├── list → Display license information
│ ├── terms → Display the software license agreement
│ ├── validate → Validate the application license
│ └── where → Show the location of the license file
├── page → Work with individual Confluence pages
│ ├── convert → Convert pages to Markdown
│ │ ├── by-id → Convert a page to Markdown by its ID
│ │ ├── by-title → Convert a page to Markdown by its title
│ │ └── by-url → Convert a page to Markdown by its URL
│ ├── count → Analyze page structure and complexity
│ │ ├── marks → Count ADF formatting marks
│ │ │ ├── by-id → Count formatting marks by page ID
│ │ │ ├── by-title → Count formatting marks by page title
│ │ │ └── by-url → Count formatting marks by URL
│ │ └── nodes → Count ADF content nodes
│ │ ├── by-id → Count content nodes by page ID
│ │ ├── by-title → Count content nodes by page title
│ │ └── by-url → Count content nodes by URL
│ ├── get → Retrieve pages in native Confluence formats
│ │ ├── by-id → Retrieve a page in native format by its ID
│ │ ├── by-title → Retrieve a page in native format by its title
│ │ └── by-url → Retrieve a page in native format by its URL
│ └── properties → List custom properties of a page
│ ├── by-id → List page properties by page ID
│ ├── by-title → List page properties by page title
│ └── by-url → List page properties by URL
├── space → Work with Confluence spaces
│ ├── convert → Convert all pages in a space to Markdown
│ │ ├── by-id → Convert a space to Markdown by its ID
│ │ └── by-key → Convert a space to Markdown by its key
│ ├── get → Download space pages in native format
│ │ ├── by-id → Download space pages in native format by ID
│ │ └── by-key → Download space pages in native format by key
│ ├── list → List all accessible Confluence spaces
│ ├── pages → List pages in a space
│ │ ├── by-id → List pages by space ID
│ │ └── by-key → List pages by space key
│ ├── permissions → List access permissions for a space
│ │ ├── by-id → List space permissions by space ID
│ │ └── by-key → List space permissions by space key
│ └── properties → List custom properties of a space
│ ├── by-id → List space properties by space ID
│ └── by-key → List space properties by space key
├── support → Generate a diagnostic bundle for support
└── tree → Display the full command tree with descriptionsSalida de tree (completa)
Sin --short, el árbol completo también muestra todos los flags de cada comando, incluyendo formas cortas, descripciones y valores predeterminados. Esto es útil para buscar flags rápidamente sin ejecutar --help en comandos individuales.
Usa tree --short cuando necesites un inventario compacto de la versión para runbooks, onboarding o documentación interna de operaciones. Usa tree (completo) cuando necesites una referencia completa de todos los flags disponibles.