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	Descripcion
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
 
# Envia el ID de página por stdin
echo "163928" | acp2md page get by-id --output page.json

Flags

Flag	Short	Predeterminado	Descripcion
`--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` (ultima)	Recupera un numero de versión concreto
`--include-labels`	`-l`	`false`	Incluye etiquetas de la página
`--include-versión`	`-V`	`false`	Incluye información de versión
`--include-versions`	`-L`	`false`	Incluye el historial completo de versiones

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
 
# Envia el título por stdin
echo "Release Notes" | acp2md page get by-title --output notes.json

Flag adicional

Flag	Short	Predeterminado	Descripcion
`--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
 
# Envia 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.

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.