Escrevendo Conteúdo em Markdown
Starlight suporta completamente a sintaxe Markdown em arquivos .md assim como frontmatter YAML para definir metadados como o título e a descrição.
Por favor verifique a documentação do MDX ou a documentação do Markdoc se estiver utilizando esses formatos de arquivo, já que o suporte e uso do Markdown podem variar.
Estilos Inline
Texto pode estar em negrito, itálico, ou tachado.
Texto pode estar em **negrito**, _itálico_, ou ~~tachado~~.Você pode fazer links para outras páginas.
Você pode [fazer links para outras páginas](/pt-br/getting-started/).Você pode destacar código inline com crases.
Você pode destacar `código inline` com crases.Imagens
Imagens no Starlight usam o suporte integrado a assets otimizados do Astro.
Markdown e MDX suportam a sintaxe do Markdown para mostrar imagens que incluem texto alternativo para leitores de tela e tecnologias assistivas.
Caminhos de imagem relativos também são suportados para imagens armazenadas localmente no seu projeto.
// src/content/docs/pagina-1.md
Cabeçalhos
Você pode estruturar o conteúdo utilizando um cabeçalho. Cabeçalhos no Markdown são indicados pelo número de # no início de uma linha.
Como estruturar o conteúdo da página no Starlight
Starlight é configurado para automaticamente utilizar o título da sua página como um cabeçalho superior e irá incluir um cabeçalho “Visão geral” no topo do índice de cada página. Nós recomendamos começar cada página com um parágrafo normal e utilizar cabeçalhos na página a partir de <h2> para baixo:
---
title: Guia de Markdown
description: Como utilizar Markdown no Starlight
---
Esta página descreve como utilizar Markdown no Starlight.
## Estilos Inline
## CabeçalhosLinks de âncora automáticos de cabeçalho
Utilizar cabeçalhos no Markdown irá automaticamente dá-lo links de âncora para que você direcione diretamente a certas seções da sua página:
---
title: Minha página de conteúdo
description: Como utilizar os links de âncora integrados do Starlight
---
## Introdução
Eu posso fazer um link para [minha conclusão](#conclusão) abaixo na mesma página.
## Conclusão
`https://meu-site.com/pagina1/#introdução` navega diretamente para minha Introdução.Cabeçalhos de Nível 2 (<h2>) e Nível 3 (<h3>) vão aparecer automaticamente no índice da página.
Asides
Asides (também conhecidos como “advertências” ou “frases de destaque”) são úteis para mostrar informações secundárias ao lado do conteúdo principal de uma página.
Starlight providencia uma sintaxe Markdown customizada para renderizar asides. Blocos Aside são indicados utilizando um par de dois pontos triplo ::: para envolver o seu conteúdo, e podem ser do tipo note, tip, caution ou danger.
Você pode aninhar qualquer outras formas de conteúdo Markdown dentro de um aside, mas asides são mais adequados para blocos curtos e concisos de conteúdo.
Aside de Nota
:::note
Starlight é um conjunto de ferramentas para websites de documentação feito com [Astro](https://astro.build/). Você pode começar com o comando:
```sh
npm create astro@latest -- --template starlight
```
:::Títulos de aside customizados
Você pode especificar um título customizado para o aside em colchetes seguindo o tipo do aside, e.x. :::tip[Você sabia?].
:::tip[Você sabia?]
Astro te ajuda a construir websites mais rápidos com a [“Arquitetura em Ilhas”](https://docs.astro.build/pt-br/concepts/islands/).
:::Mais tipos de aside
Asides de cuidado e perigo são úteis para chamar a atenção de um usuário a detalhes que podem o atrapalhar. Se você anda os utilizando muito, pode ser um sinal de que o que você está documentando se beneficiaria com uma mudança.
:::caution
Se você não tem certeza de que você quer um site de documentação incrível, pense novamente antes de utilizar [Starlight](../../).
:::
:::danger
Seus usuários podem ser mais produtivos e considerar seu produto mais fácil de usar graças a funcionalidades úteis do Starlight.
- Navegação compreensível
- Tema de cores configurável pelo usuário
- [Suporte a internacionalização](/pt-br/guides/i18n)
:::Citações
Esta é uma citação, que é comumente utilizada ao citar outra pessoa ou documento.
Citações são indicadas com um
>no começo de cada linha.
> Esta é uma citação, que é comumente utilizada ao citar outra pessoa ou documento.
>
> Citações são indicadas com um `>` no começo de cada linha.Blocos de código
Um bloco de código é indicado por um bloco com três crases ``` no começo e fim. Você pode indicar a linguagem de programação sendo utilizada após as crases iniciais.
// Código JavaScript com syntax highlighting.
var divertido = function lingua(l) {
formatodata.i18n = require('./lingua/' + l);
return true;
};```js
// Código JavaScript com syntax highlighting.
var divertido = function lingua(l) {
formatodata.i18n = require('./lingua/' + l);
return true;
};
```Longos blocos de código de linha única não devem quebrar linha. Eles devem rolar horizontalmente se forem muito longos. Esta linha deve ser longa o suficiente para demonstrar isso.Outras funcionalidades comuns do Markdown
Starlight suporta todo o resto da sintaxe de escrita do Markdown, como listas e tabelas. Veja a Cheat Sheet de Markdown do The Markdown Guide para uma visão geral rápida de todos os elementos da sintaxe do Markdown.
Markdown Avançado e Configurando MDX
O Starlight utiliza o mesmo rendizador Markdown e MDX do Astro, que suporta remark e rehype. Você pode adicionar sintaxe e comportamento personalizado adicionando remarkPlugins ou rehypePlugins no seu arquivo de configuração Astro. Visite Configurando Markdown e MDX na documentação do Astro para saber mais.