Noções básicas de MDX

Todas as páginas do Jamdesk são arquivos .mdx: Markdown padrão com componentes JSX, como <Card>, <Tabs> e <Accordion>.

O que é MDX?

MDX permite escrever Markdown padrão e incorporar componentes JSX no mesmo arquivo. Escreva títulos, listas e blocos de código em Markdown e, em seguida, adicione componentes como <Card> ou <Tabs> sempre que precisar de interatividade.

MDX também funciona bem para documentação que ferramentas de IA precisam ler: é texto simples (para que possam lê-lo e escrevê-lo nativamente), pode ser versionado no Git e tem estrutura suficiente para componentes sem exigir um formato proprietário.

# 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>

Estrutura da página

Todas as páginas MDX começam com frontmatter — metadados entre três traços:

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

Your content starts here...

Fundamentos do Markdown

Títulos

Use ## para seções principais e ### para subseções. O Jamdesk gera automaticamente um índice a partir dos seus títulos.

## Main Section
Content under the main section.

### Subsection
More detailed content here.

Formatação de texto

Listas

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

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

Citações em bloco

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

Este é um bloco de citação. Use-o para callouts ou para destacar informações importantes.

Adicionando componentes

Componentes são elementos JSX que você pode usar em qualquer lugar do seu MDX. Eles podem ser autocontidos ou envolver conteúdo:

{/* 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 disponíveis

O Jamdesk fornece estes componentes integrados:

Tabelas

As tabelas padrão do Markdown funcionam imediatamente:

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

Para recursos avançados, como destaque de linhas, alinhamento de células e mesclagem, use o componente Table:

Comentários

Adicione comentários que não aparecerão no conteúdo renderizado:

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

O que vem a seguir?