O Markdown numa página.O que escreve, o que obtém.

Títulos, texto e quebras de linha

Uma linha em branco começa um novo parágrafo. Uma só quebra de linha dentro de um parágrafo é ignorada e as linhas juntam-se. Para forçar uma quebra, termine a linha com dois espaços ou uma barra invertida.

Listas, listas de tarefas e tabelas

- Milk
- Bread
  - Rye
  - Wheat

1. Open the folder
2. Pick a file

- [x] Write the plan
- [ ] Review it

Uma lista com marcas começa cada linha com -, * ou +. Indente com dois ou quatro espaços para aninhar. Numa lista numerada basta que o primeiro número esteja certo. Uma lista de tarefas é uma lista com marcas com [ ] ou [x] à frente, e aparece como caixas de seleção.

| Plan  | Price | Users |
|-------|------:|:-----:|
| Free  |    $0 |   1   |
| Team  |   $12 |  10   |

Numa tabela, a segunda linha separa o cabeçalho das linhas. :--- alinha uma coluna à esquerda, ---: à direita e :---: ao centro. As colunas não precisam de estar alinhadas no texto. Para pôr um | dentro de uma célula, escreva \|.

Código

Envolva o código em linha entre acentos graves simples. Para um bloco, ponha três acentos graves na linha antes e na linha depois, e escreva a linguagem a seguir aos primeiros para obter cores de sintaxe:

```swift
let greeting = "Hello"
```

Um bloco marcado diff colore as linhas que começam por + e -. Um bloco marcado mermaid torna-se um diagrama.

Ligações e imagens

[DotMD](https://getdotmd.com)
![A cat on a keyboard](assets/cat.png)
[the plan](plan.md)
[setup](#setup)

Uma ligação tem o texto entre parênteses retos e o endereço entre parênteses curvos. Um endereço web sozinho também se torna uma ligação. Uma imagem é uma ligação com um ! à frente; o seu texto descreve-a para os leitores de ecrã. Os caminhos são relativos ao documento, e uma ligação pode apontar para outro ficheiro .md ou para um título, cuja âncora é o seu texto em minúsculas com os espaços convertidos em -.

Para endereços longos ou repetidos, ponha-os no fim e refira-os por um nome curto: [guia][1], e depois [1]: https://example.com/guide numa linha só sua.

Callouts, comentários e front matter

> [!NOTE]
> Useful information that users should know.

Uma citação cuja primeira linha é [!NOTE], [!TIP], [!IMPORTANT], [!WARNING] ou [!CAUTION] torna-se uma caixa colorida, com a mesma sintaxe do GitHub.

• Comentários que não aparecem na página: <!-- uma nota só visível no texto -->.
• Secções recolhíveis com <details> e <summary> do HTML, com linhas em branco à volta do Markdown no interior.
• Front matter: um bloco entre duas linhas --- logo nas primeiras linhas do ficheiro, com um título, etiquetas ou um estado. O DotMD mostra-o como um cartão Properties acima do documento.

Fórmulas e diagramas

Dois extras que tanto o GitHub como o DotMD desenham. Uma fórmula vai entre sinais de dólar, $E = mc^2$, ou entre sinais duplos numa linha só sua: Fórmulas em Markdown com LaTeX. Um diagrama é um bloco de código marcado mermaid, com o seu texto dentro: Diagramas Mermaid.

Experimente

A forma mais rápida de aprender os sinais é vê-los formatados. Abra qualquer ficheiro .md no DotMD e leia-o formatado, com tabelas, código, callouts, diagramas e fórmulas desenhados. Ler é grátis. No editor, o menu Insert escreve os símbolos por si, por isso não precisa de se lembrar de nada disto.

Perguntas sobre a sintaxe Markdown

Mais perguntas