Conceptos básicos de MDX

Cada página de Jamdesk es un archivo .mdx — Markdown estándar con componentes JSX como <Card>, <Tabs> y <Accordion>.

¿Qué es MDX?

MDX combina la simplicidad de Markdown con el poder de JSX. Escribe encabezados, listas y bloques de código en Markdown, luego agrega componentes como <Card> o <Tabs> donde necesites interactividad.

MDX es también uno de los mejores formatos para documentación que necesita ser legible por IA. Es texto plano (por lo que las herramientas de IA pueden leerlo y escribirlo de forma nativa), versionable en Git y suficientemente estructurado para componentes sin requerir un formato propietario.

# Welcome to My Docs

This is regular **Markdown** with a component below:

<Card title="Quickstart" icon="rocket" href="/quickstart">

  Jump right in with our quickstart guide.

</Card>

Estructura de la página

Cada página MDX comienza con frontmatter — metadatos entre triples guiones:

---
title: My Page Title
description: A brief description for search and previews
---

Your content starts here...

Fundamentos de Markdown

Encabezados

Usa ## para las secciones principales y ### para las subsecciones. Jamdesk genera automáticamente una tabla de contenidos a partir de tus encabezados.

## Main Section
Content under the main section.

### Subsection
More detailed content here.

Formato de texto

Listas

Unordered list:
- First item
- Second item
  - Nested item

Ordered list:
1. First step
2. Second step
3. Third step

Citas en bloque

> This is a blockquote. Use it for callouts or
> highlighting important information.

Esto es una cita en bloque. Úsala para llamadas de atención o para destacar información importante.

Agregar componentes

Los componentes son elementos JSX que puedes usar en cualquier lugar de tu MDX. Pueden ser auto-cerrados o envolver contenido:

{/* Self-closing component */}
<Card title="Example" icon="star" href="/introduction" />

{/* Component wrapping content */}
<Accordion title="Click to expand">

  This content is inside the accordion.

</Accordion>

Componentes disponibles

Jamdesk ofrece un rico conjunto de componentes integrados:

Tablas

Las tablas estándar de Markdown funcionan de inmediato:

| Feature | Free | Pro |
|---------|------|-----|
| Pages | 10 | Unlimited |
| Custom domain | No | Yes |

Para funciones avanzadas como resaltado de filas, alineación de celdas y spanning, usa el componente Table:

Comentarios

Agrega comentarios que no aparecerán en la salida renderizada:

{/* This is a comment - it won't be visible to readers */}

¿Qué sigue?