Recuperar páginas

Los comandos page get recuperan una página de Confluence en su formato nativo. No se aplica conversión a Markdown. Esto es útil para inspeccionar la estructura en bruto de la página, construir pipelines de procesamiento propios o archivar el contenido original.

Hay dos formatos disponibles:

Formato	Valor del flag	Descripción
ADF (predeterminado)	`atlas_doc_format`	Atlassian Document Format, JSON estructurado
Storage	`storage`	Confluence Storage Format, XML/HTML

Obtener por ID


acp2md page get by-id PAGE_ID [flags]

Ejemplos


# Imprime ADF JSON en stdout
acp2md page get by-id 163928
 
# Guarda ADF JSON en un archivo
acp2md page get by-id 163928 --output page.json
 
# Obtiene el formato Storage (HTML/XML)
acp2md page get by-id 163928 --format storage --output page.html
 
# Obtiene la versión borrador en formato ADF
acp2md page get by-id 163928 --get-draft --output draft.json
 
# Envía el ID de página por stdin
echo "163928" | acp2md page get by-id --output page.json

Flags

Flag	Short	Predeterminado	Descripción
`--output`	`-o`	(stdout)	Ruta del archivo de salida
`--format`	`-f`	`atlas_doc_format`	Formato de salida: `atlas_doc_format` (ADF JSON) o `storage` (HTML/XML)
`--get-draft`	`-d`	`false`	Recupera la versión borrador (no publicada)
`--status`	`-s`	`current`	Filtro de estado de página: `current`, `archived`, `trashed`, `deleted`, `draft`
`--version`	`-v`	`-1` (última)	Recupera un número de versión concreto
`--include-labels`	`-l`	`false`	Incluye etiquetas de la página
`--include-version`	`-V`	`false`	Incluye información de versión
`--include-versions`	`-L`	`false`	Incluye el historial completo de versiones
`--attachments-dir`	—	—	Descarga los adjuntos de la página en este directorio (v1.0.12)
`--conflict-resolution`	—	`overwrite`	Conflictos con el archivo de salida: `overwrite`, `skip`, `versioned`

Obtener por título


acp2md page get by-title "PAGE TITLE" [flags]

Ejemplos


# Obtiene ADF JSON por título
acp2md page get by-title "My Page Title"
 
# Guarda en un archivo
acp2md page get by-title "Project Notes" --output page.json
 
# Obtiene formato Storage
acp2md page get by-title "Technical Spec" --format storage --output page.html
 
# Obtiene el borrador ordenado por la modificacion mas reciente
acp2md page get by-title "Meeting Notes" --get-draft --sort -modified-date
 
# Envía el título por stdin
echo "Release Notes" | acp2md page get by-title --output notes.json

Flag adicional

Flag	Short	Predeterminado	Descripción
`--sort`	`-S`	(ninguno)	Ordena resultados: `id`, `-id`, `created-date`, `-created-date`, `modified-date`, `-modified-date`, `title`, `-title`

El resto de los flags de by-id también están disponibles.

Obtener por URL


acp2md page get by-url URL [flags]

Alias: url, u

Extrae el ID de página de una URL de Confluence y recupera la página en su formato nativo. Es útil cuando tienes la URL del navegador y quieres evitar buscar el ID manualmente.

Formatos de URL compatibles:

https://domain.atlassian.net/wiki/spaces/KEY/pages/123456/Page+Title
https://domain.atlassian.net/wiki/spaces/KEY/pages/123456
https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Ejemplos


# Obtiene ADF JSON desde una URL de Confluence
acp2md page get by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/163928/API+Reference"
 
# Guarda en un archivo
acp2md page get by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/163928" --output page.json
 
# Obtiene formato Storage
acp2md page get by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/163928" --format storage --output page.html
 
# También funciona con URLs viewpage
acp2md page get by-url "https://mycompany.atlassian.net/wiki/pages/viewpage.action?pageId=163928" --output page.json
 
# Envía la URL por stdin
echo "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/163928" | acp2md page get by-url > page.json

Flags

Se aplican todos los flags de by-id.

Guardar adjuntos

--attachments-dir DIR (disponible desde v1.0.12) descarga los adjuntos de la página en DIR/<page-id>/ y describe cada uno —título en Confluence, ID de archivo, tipo de medio, versión, tamaño y SHA-256— para que la página pueda restaurarse más adelante con sus archivos:

con atlas_doc_format, en un array attachments añadido al JSON de la página;
con storage, cuya salida es XHTML sin envoltorio, en DIR/<page-id>.attachments.json.


# Copia de seguridad de una página con sus adjuntos
acp2md page get by-id 2973106197 -o ./page.json --attachments-dir ./attachments

Un título con caracteres que ningún sistema de archivos acepta se guarda con un nombre seguro; la descripción conserva el título original. Un archivo que no se puede descargar se notifica por stderr y se lista sin file_path. El flag funciona igual en page get by-title y page get by-url.

Procesar salida ADF con jq

Ejemplo anonimo basado en una página real recuperada con page get by-id:


{
  "title": "Decision log",
  "id": "298494",
  "status": "current",
  "spaceId": "298324",
  "body": {
    "atlas_doc_format": {
      "representation": "atlas_doc_format",
      "value": {
        "type": "doc",
        "versión": 1,
        "content": [
          {
            "type": "layoutSection"
          }
        ]
      }
    }
  },
  "versión": {
    "number": 1
  }
}

El formato ADF es JSON estandar y se puede procesar con jq:


# Extrae el título de la página
acp2md page get by-id 163928 | jq '.title'
 
# Lista todos los tipos de nodo del cuerpo del documento
acp2md page get by-id 163928 | jq '[.. | objects | .type] | unique'
 
# Formatea y guarda
acp2md page get by-id 163928 | jq '.' > page-pretty.json

Usa acp2md page count nodes by-id y acp2md page count marks by-id para un análisis estructurado de la distribucion de tipos de nodo y marks sin necesidad de procesar el JSON manualmente.