{"schemaVersion":1,"title":"Artículos enriquecidos","url":"https://appgram.github.io/docsy/versions/current/es/guides/tutorials/rich-articles","markdownUrl":"https://appgram.github.io/docsy/format-md/versions/current/es/guides/tutorials/rich-articles","jsonUrl":"https://appgram.github.io/docsy/agent/pages/versions/current/es/guides/tutorials/rich-articles.json","version":"current","locale":"es","markdown":"# Artículos enriquecidos\n\nAñade avisos, pasos, pestañas, grupos de código y fragmentos reutilizables con Markdown.\n\nWritten by: [nedimf](https://github.com/nedimf), [AppGram](https://appgram.dev)\n\nLos componentes de Docsy se escriben directamente en Markdown. La configuración sigue en YAML y el contenido permanece legible en tu repositorio y en las exportaciones para agentes. No necesitas un editor alojado ni fuentes tipográficas remotas.\n\n## Avisos\n\n> La configuración pertenece a YAML\n>\n> Mantén la identidad del producto, la navegación, las fuentes y los permisos en `docsy.config.yaml`. Escribe las explicaciones aquí, en Markdown.\n\n> Valida antes de publicar\n>\n> Ejecuta `npm run validate` para detectar enlaces rotos, componentes inválidos y errores de importación antes de publicar.\n\n> Guarda los secretos fuera del repositorio\n>\n> Lee las credenciales privadas desde el entorno del servidor. Nunca las incluyas en YAML ni en ejemplos publicados.\n\n> Un sitio estático no puede proteger artículos privados\n>\n> Usa el servidor Node para la documentación bloqueada. Un control realizado únicamente en el navegador no puede proteger un archivo público.\n\nCada tipo tiene su propio icono y un acento visual discreto. El título explica la situación y el cuerpo indica qué hacer. La distinción no depende solo del color.\n\n```md\n:::warning[Guarda los secretos fuera del repositorio]\nLee las credenciales privadas desde el entorno del servidor.\n:::\n```\n\n## Pasos numerados\n\n> 1. **Genera un proyecto.** Empieza con la interfaz editable de Docsy.\n>\n> 2. **Configura las fuentes.** Declara los artículos, la especificación de la API y los metadatos del SDK en YAML.\n>\n> 3. **Valida y publica.** Revisa el resultado antes del despliegue.\n\nColoca una lista ordenada de Markdown entre `:::steps` y `:::`. Cada paso puede incluir párrafos y bloques de código.\n\n## Pestañas sincronizadas\n\nLos grupos que comparten la clave `sync` recuerdan la misma etiqueta usando únicamente el almacenamiento local del navegador.\n\n> > npm\n> >\n> > ```bash\n> > npm run validate\n> > npm run build\n> > ```\n>\n> > pnpm\n> >\n> > ```bash\n> > pnpm validate\n> > pnpm build\n> > ```\n\nUsa cuatro signos de dos puntos para el grupo `tabs` y tres para cada elemento `tab`. Puedes navegar con las flechas, Inicio y Fin. Sin JavaScript, todos los paneles siguen visibles.\n\n## Grupos de código\n\nRodea los bloques de código con `:::code-group`. El texto que aparece después del lenguaje del bloque se convierte en la etiqueta de la pestaña.\n\n> ```javascript JavaScript\n> console.log('Una documentación que te pertenece.');\n> ```\n>\n> ```python Python\n> print('Una documentación que te pertenece.')\n> ```\n\n## Explicaciones desplegables\n\n> ¿Qué ocurre sin JavaScript?\n>\n> Todas las pestañas siguen siendo legibles y las secciones desplegables usan el elemento nativo `details` del navegador. La búsqueda indexa todos los paneles, no solo el seleccionado.\n\n## Fragmentos reutilizables\n\nDeclara los archivos Markdown en YAML:\n\n```yaml\ncontent:\n  snippets:\n    publicacionEs: content/snippets/publishing-checklist.es.md\n```\n\nDespués, inserta `::include{src=\"publicacionEs\"}` en su propia línea:\n\n* Valida las fuentes configuradas, los enlaces internos y las anclas.\n* Genera las versiones y los idiomas que quieras publicar.\n* Revisa los ejemplos y los permisos antes del despliegue.\n\nLos fragmentos se incorporan a los artículos, la búsqueda y las exportaciones Markdown y JSON. Los nombres desconocidos, las referencias circulares, las rutas fuera del proyecto y más de diez inclusiones anidadas hacen fallar la validación.\n\n## Elegir los componentes permitidos\n\n```yaml\ncontent:\n  components: [note, tip, warning, danger, steps, tabs, accordion, code-group, include]\n```\n\nUn componente desconocido, desactivado o mal formado impide la publicación. El componente `tab` siempre debe estar dentro de `tabs`.\n\n","contentLocale":"es","isFallback":false,"authorship":{"authors":[{"name":"nedimf","kind":"human","github":"nedimf","avatar":"/docsy/assets/authors/nedimf.png","role":"AppGram","id":"nedimf","url":"https://github.com/nedimf"},{"name":"AppGram","kind":"organization","github":"AppGram","url":"https://appgram.dev","avatar":"/docsy/assets/ag-logo.svg","id":"appgram"}],"contributors":[],"reviewedBy":[]},"editUrl":"https://github.com/AppGram/docsy/edit/main/content/es/rich-articles.md"}