---
title: Escrita e organização
sidebarTitle: Visão geral da escrita
description: >-
  Tudo sobre criar páginas no Jamdesk: sintaxe MDX, blocos de código, mídia incorporada, SEO e ferramentas para visualizar seu trabalho antes da publicação.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

As páginas do Jamdesk são arquivos MDX: Markdown padrão com componentes React disponíveis sempre que você precisar deles. Uma página é apenas frontmatter e conteúdo.

```mdx
---
title: Rate Limits
description: How rate limiting works across API tiers.
---

Requests are limited per API key.

<Note>Enterprise plans have custom limits.</Note>
```

A maior parte do que você escreverá será Markdown simples. As páginas desta seção abordam o restante: blocos de código com destaque de sintaxe, imagens e vídeos, notação matemática, snippets reutilizáveis e os campos de frontmatter que controlam títulos, ícones e metadados de SEO.

## MDX e páginas

<Columns cols={3}>
  <Card title="Noções básicas de MDX" icon="pen-to-square" href="/pt/content/mdx-basics">
    Markdown com componentes React incorporados. Comece aqui.
  </Card>
  <Card title="Blocos de código" icon="code" href="/pt/content/code-blocks">
    Destaque de sintaxe, números de linha, nomes de arquivo e CodeGroups
  </Card>
  <Card title="Componentes React personalizados" icon="puzzle-piece" href="/pt/content/react-components">
    Defina seus próprios componentes com renderização no servidor e Tailwind
  </Card>
  <Card title="Frontmatter" icon="file-lines" href="/pt/content/frontmatter">
    Títulos, descrições, ícones, substituições da barra lateral e metadados de SEO
  </Card>
  <Card title="Cabeçalhos" icon="heading" href="/pt/content/headers">
    Cabeçalhos H2 e H3 que preenchem o índice
  </Card>
  <Card title="Ícones" icon="icons" href="/pt/content/icons">
    Ícones Font Awesome Pro em cards, chamadas, navegação e texto inline
  </Card>
  <Card title="Links e âncoras" icon="link" href="/pt/content/links">
    Links internos, âncoras de cabeçalho e URLs externas
  </Card>
  <Card title="Math e LaTeX" icon="square-root-variable" href="/pt/content/math">
    Renderização KaTeX para equações e expressões
  </Card>
  <Card title="SEO" icon="magnifying-glass" href="/pt/content/seo">
    Meta tags, prévias para redes sociais e sitemaps gerados automaticamente
  </Card>
  <Card title="Páginas ocultas" icon="eye-slash" href="/pt/content/hidden-pages">
    Mantenha páginas fora da barra lateral e da pesquisa sem excluí-las
  </Card>
  <Card title="Snippets" icon="clone" href="/pt/content/snippets">
    Blocos de conteúdo reutilizáveis que você importa entre páginas
  </Card>
</Columns>

## Mídia e incorporações

<Columns cols={2}>
  <Card title="Imagens" icon="image" href="/pt/content/images">
    Dimensionamento, legendas, variantes claras/escuras e formatos compatíveis
  </Card>
  <Card title="YouTube" icon="circle-play" href="/pt/content/youtube">
    Vídeos e Shorts carregados sob demanda com tempos de início personalizados
  </Card>
  <Card title="Vídeos" icon="video" href="/pt/content/videos">
    MP4 e WebM com propriedades de reprodução automática, loop e pôster
  </Card>
  <Card title="iFrames" icon="window-restore" href="/pt/content/iframes">
    Vimeo, CodePen, Figma, Loom e outras incorporações externas
  </Card>
</Columns>

## Ferramentas de criação

Você não precisa fazer push para ver suas alterações. Visualize localmente com a CLI, edite no navegador ou controle o servidor de desenvolvimento pelo VS Code.

<Columns cols={3}>
  <Card title="Prévia local" icon="terminal" href="/pt/development/local-preview">
    Execute sua documentação na máquina com recarregamentos instantâneos
  </Card>
  <Card title="Editor web" icon="browser" href="/pt/development/web-editor">
    Edite MDX no navegador com prévia ao vivo e faça commit diretamente no repositório
  </Card>
  <Card title="Extensão do VS Code" icon="square-code" href="/pt/development/vscode-extension">
    Inicie e pare o servidor de desenvolvimento pela barra de status
  </Card>
</Columns>

```