Formateador OpenAPI en línea — Embellecer JSON y YAML

Formatea documentos OpenAPI 3.0–3.2 (JSON o YAML) en el navegador — indentación 2 o 4, sin envío al servidor.

Cargando…
Documentación Formatear OpenAPI
Pretty-print de OpenAPI JSON o YAML en el navegador.

Notas para desarrolladores

• Pretty-print genérico (JSON.stringify / yaml.dump) — ordenación recursiva de claves opcional para diffs estables. • Se conserva el tipo de entrada: JSON → JSON; YAML → YAML. • Autoformato al pegar/subir/ejemplo; las ediciones manuales usan Formatear (⌘↵). • Los comentarios YAML se pierden al formatear. • Las versiones openapi numéricas en YAML (p. ej. 3.0) se normalizan a cadenas (3.0.0). • Máximo 512 KiB.

Opciones

Indentación
Espacios por nivel para JSON.stringify / yaml.dump (2 o 4).
Ordenar claves
Desactivado por defecto (conserva el orden de claves). Activado: ordena recursivamente las claves de objetos para diffs de PR estables; el orden de los elementos de arrays no cambia.

Casos de uso

• Limpiar OpenAPI JSON/YAML minificado o editado a mano antes de la revisión. • Normalizar la indentación (2 o 4 espacios) para diffs de PR. • Encadenar con Validar OpenAPI después del formateo.

Ejemplos

JSON compacto → indentado

Antes

{"openapi":"3.1.0","info":{"title":"Pets API","version":"1.0.0","description":"Simple pet store API"},"paths":{"/pets":{"get":{"operationId":"listPets","tags":["pets"],"summary":"List pets","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Pet"}}}}}}}}},"components":{"schemas":{"Pet":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}

Después

{ "openapi": "3.1.0", "info": { "title": "Pets API", "version": "1.0.0", "description": "Simple pet store API" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": [ "pets" ], "summary": "List pets", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Pet" } } } } } } } } }, "components": { "schemas": { "Pet": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } } } } }

YAML conservado como YAML

Antes

openapi: "3.0.3" info: title: Pets version: 1.0.0 paths: {}

Después

openapi: "3.0.3" info: title: Pets version: 1.0.0 paths: {}

FAQ Formatear OpenAPI

Preguntas frecuentes

¿El formato conserva JSON frente a YAML?

Sí. Una entrada JSON produce JSON indentado; una entrada YAML produce YAML vía yaml.dump. Los comentarios YAML no se conservan.

¿Es un pretty-printer consciente de OpenAPI?

El pretty-print sigue siendo genérico (JSON.stringify / yaml.dump). Activa Ordenar claves para un orden alfabético recursivo (diffs estables). No es un reordenamiento consciente de OpenAPI (paths antes que components, etc.).

¿Y openapi: 3.0 como número YAML?

Las versiones numéricas se normalizan a cadenas (3 → 3.0.0, 3.0 → 3.0.0) antes de la salida.

¿Qué versiones de OpenAPI?

OpenAPI 3.0, 3.1 y 3.2. Swagger 2.0 no está soportado — usa nuestras herramientas OpenAPI solo para 3.x.

API y esquemas

Herramientas OpenAPI para formatear, validar y analizar tus specs.

Explorar otras categorías de herramientas

Minificar

Reduce código y assets para producción — minifica JavaScript, CSS, HTML, JSON y XML antes de gzip o un despliegue CDN.

Embellecer

Haz el código legible con una indentación coherente — embellece JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML y más en tu navegador.

Desminificar

Expande código minificado o comprimido — desminifica JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML y otros formatos al depurar o revisar.

Conversión

Transforma datos entre JSON, YAML, XML y CSV en local — sin subidas a un servidor.

Preprocesadores CSS

Compila SCSS o LESS a CSS estándar en el navegador — combínalo con embellecer o minificar para un flujo de hoja de estilos completo.

Herramientas JSON

Valida, formatea, compara y explora payloads JSON — complementarias a minificadores y convertidores.

Herramientas SVG

Previsualiza, optimiza con SVGO, exporta Data URI, redimensiona, embellece, convierte a JSX y valida SVG — todo en tu navegador.

DevOps e Infra

Formato, validación y minificación de Terraform HCL, formato y lint de Dockerfile, validación de Docker Compose y .env.

CI/CD

GitHub Actions y GitLab CI — formatear YAML y comprobar la estructura de workflows/jobs en el navegador.

Logs y observabilidad

JSON/NDJSON línea a línea y access logs de Nginx/Apache — formato, filtro, validación y CSV/TSV.

Kubernetes

Manifiestos multi-doc, validación estructural, starters Ingress/Deployment y formato de values de Helm.

Red / IP

CIDR, subredes y ayudas IPv4/IPv6 — en tu navegador.

Seguridad y tokens

JWKS, certificados X.509 y escaneo de secretos — en local en el navegador.

Codificación

Codifica o decodifica Base64, componentes URL y entidades HTML — solo en el cliente.

Utilidades para desarrolladores

Timestamps, UUID, ULID, Nanoid, cron, contraseñas, regex, slugify, bases numéricas, mayúsculas, diff de texto y chmod — todo en el cliente.

Texto y Markdown

Cuenta palabras, genera TOC Markdown y limpia listas de líneas — todo en tu navegador.

IA y LLM

Conteo de tokens, estimación de costes y ajuste a la ventana de contexto — 100 % en el navegador.

Datos de prueba

Valores de campo sintéticos para fixtures y seed de BD — primero números de teléfono en rangos reservados.

Serialización

Serializa y deserializa estructuras PHP junto a los flujos JSON.