Guia Rápido de Markdown no Obsidian

Use esta página como uma referência de copiar e colar para o Markdown que você mais usa no Obsidian. Ela cobre o Markdown padrão, extensões do Obsidian como wikilinks e callouts, e os atalhos de teclado que ajudam você a editar notas rapidamente.

O Obsidian começa com o CommonMark e o GitHub-Flavored Markdown, e adiciona recursos para notas conectadas: [[wikilinks]], ![[incorporacoes]], callouts, destaques, comentários, referências de bloco e propriedades. O Markdown padrão costuma ser a opção mais portátil; a sintaxe do Obsidian é a melhor escolha quando a nota deve funcionar dentro do seu cofre (vault).

Referência rápida

Necessidade	Sintaxe	Exemplo
Título	# a ######	## Notas do projeto
Negrito	**texto**	**importante**
Itálico	*texto*	*opcional*
Tachado	~~texto~~	~~plano antigo~~
Destaque	==texto==	==decisao==
Link externo	[rotulo](url)	[Ajuda do Obsidian](https://obsidian.md/help)
Link interno	[[Nota]]	[[Briefing do projeto]]
Tarefa	- [ ]	- [ ] Enviar acompanhamento
Callout	> [!tipo]	> [!tip] Experimente este fluxo
Incorporação de nota	![[Nota]]	![[Notas da reuniao]]
Código em linha	`codigo`	`status: rascunho`
Comentário	%%texto%%	%%Visivel apenas durante a edicao%%

Formatação de texto e estrutura

# Título 1
## Título 2
### Título 3

**Texto em negrito**
*Texto em itálico* ou _texto em itálico_
***Texto em negrito e itálico***
~~Texto tachado~~
==Texto destacado==

> Um bloco de citação pode conter um trecho útil ou um lembrete.

---

Use uma linha em branco para iniciar um novo parágrafo. Um único Enter dentro de um parágrafo é normalmente tratado como uma quebra de linha suave. Para uma quebra de linha rígida, use Shift+Enter ou adicione dois espaços antes de pressionar Enter. Se precisar de comportamento compatível com Markdown em vários editores, marque Configurações → Editor → Quebras de linha estritas.

Para exibir caracteres Markdown literalmente, use uma barra invertida antes deles:

\*Isto não está em itálico\*
1\. Isto não é um item de lista
\# Isto não é um título

Listas, listas de verificação e aninhamento

- Primeiro item
- Segundo item
  - Item aninhado

1. Primeiro passo
2. Segundo passo

- [ ] Tarefa aberta
- [x] Tarefa concluída
  - [ ] Subtarefa

No modo de leitura, você pode clicar na caixa de seleção de uma tarefa para alterá-la. Para datas de vencimento, tarefas recorrentes e consultas em várias notas, consulte o guia completo de gerenciamento de tarefas no Obsidian.

Links e incorporações

Links internos

[[Nome da nota]]
[[Nome da nota|Texto de exibição]]
[[Nome da nota#Título]]
[[Nome da nota#Título|Texto de exibição]]
[[Nome da nota#^block-id]]

[[Nome da nota]] aponta para outra nota no cofre. Adicione | para um alias, # para um título ou #^ para uma referência de bloco. Use o prefixo ! para incorporar em vez de apenas linkar:

![[Nome da nota]]
![[Nome da nota#Título]]
![[Nome da nota#^block-id]]
![[imagem.png]]
![[imagem.png|400]]

As incorporações são úteis quando uma definição reutilizável, uma decisão de reunião ou uma lista de verificação deve aparecer em mais de um lugar enquanto permanece editável em uma única nota de origem.

Links externos e imagens

[Ajuda do Obsidian](https://obsidian.md/help)
![Descrição](https://example.com/imagem.png)

Use texto de link descritivo. Para notas que possam sair do seu cofre, os links Markdown padrão são mais portáteis do que os wikilinks.

Tabelas

Uma tabela precisa de uma linha de cabeçalho e uma linha delimitadora. Cada célula delimitadora precisa de pelo menos dois hífens:

| Status | Próxima ação |
| --- | --- |
| Aberto | Revisar hoje |
| Concluído | Arquivar nota |

Alinhe as colunas com dois-pontos na linha delimitadora:

| Esquerda | Centro | Direita |
| :--- | :---: | ---: |
| A | B | C |

Na Visualização ao vivo, use o menu de contexto da tabela ou o comando Inserir tabela para adicionar linhas e colunas. Se uma tabela não for renderizada, verifique estas causas comuns:

• Adicione uma linha em branco antes da tabela.
• Mantenha a linha delimitadora diretamente abaixo do cabeçalho.
• Escape uma barra vertical literal dentro de uma célula como \|.
• Mantenha blocos de código multilinha fora de células de tabela; use uma nota linkada ou incorporada quando o exemplo precisar de mais de uma linha.

Callouts

Callouts são blocos de citação estilizados. O identificador de tipo controla o ícone e a cor; o título é opcional.

> [!tip] Um título curto
> Mantenha o conselho próximo ao parágrafo que ele explica.

> [!warning]- Um aviso recolhido
> Este conteúdo começa recolhido.

Os tipos integrados comuns incluem note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example e quote. O sufixo + inicia um callout expandido; o sufixo - inicia recolhido. Veja o guia completo de callouts do Obsidian para CSS personalizado e solução de problemas.

Código, notas de rodapé, comentários e matemática

Use uma crase simples para código em linha e três crases para um bloco de código. Adicione um identificador de linguagem para destaque de sintaxe:

Use `Ctrl+P` para abrir a paleta de comandos.

```js
const noteType = "project";
```

As notas de rodapé usam uma referência e uma definição:

O Obsidian armazena notas como arquivos Markdown.[^1]

[^1]: Confirme o comportamento na documentação oficial de ajuda do Obsidian.

Os comentários ficam ocultos no modo de leitura e no Obsidian Publish:

Texto visível %%lembrete apenas para o editor%%

Para matemática, use um único cifrão para expressões em linha e cifrões duplos para um bloco:

Em linha: $a^2 + b^2 = c^2$

$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

Atalhos de teclado essenciais

Estes são valores padrão úteis, não um substituto para sua própria configuração de atalhos:

Ação	Windows/Linux	macOS
Nova nota	Ctrl+N	Cmd+N
Paleta de comandos	Ctrl+P	Cmd+P
Colar sem formatação	Ctrl+Shift+V	Cmd+Shift+V
Excluir linha atual sem seleção	Ctrl+Shift+K	Cmd+Shift+K
Negrito no texto selecionado	Ctrl+B	Cmd+B
Itálico no texto selecionado	Ctrl+I	Cmd+I

O Obsidian separa atalhos de edição do sistema de atalhos de comando personalizáveis. Abra Configurações → Atalhos de teclado para verificar ou alterar comandos como inserir um modelo, abrir uma nota diária ou executar uma ação de plugin. Em um layout de teclado não-US, a tecla exibida pode não corresponder ao rótulo físico da tecla.

Tabela prática de decisão de formatação

Se você precisa…	Prefira	Por quê
Compartilhar a nota com outros editores Markdown	Links, títulos, listas e tabelas Markdown padrão	São as estruturas mais portáveis.
Conectar notas em um cofre	Wikilinks e referências de bloco	O Obsidian pode resolver nomes de notas e linkar para seções exatas.
Reutilizar uma lista de verificação ou definição	Uma incorporação	Uma única fonte pode ser atualizada em várias notas.
Explicar uma decisão sem interromper a leitura	Um callout	O conteúdo permanece visível, mas visualmente secundário.
Acompanhar trabalho nas notas diárias	Tarefas com um modelo consistente	A sintaxe de tarefas permanece legível mesmo sem plugins.

Esta distinção previne uma falha comum: criar uma nota bonita que só funciona em uma visualização ou em um aplicativo. Comece com Markdown portátil e adicione recursos do Obsidian apenas onde eles eliminarem fricção real.

Checklist de solução de problemas

Quando a formatação parecer incorreta no modo de leitura, verifique a sintaxis nesta ordem:

1. Confirme se todo bloco de código delimitado possui crases de fechamento.
2. Adicione uma linha em branco antes de um novo parágrafo, tabela, lista ou callout.
3. Verifique se um |, *, _, # ou crase precisa ser escapado.
4. Para uma tabela, verifique a linha delimitadora e remova blocos multilinha das células.
5. Para quebras de linha, use intencionalmente Shift+Enter, dois espaços no final ou a opção de Quebras de linha estritas.
6. Se um comando não for executado, procure por ele na paleta de comandos e inspecione seu atalho atribuído.

Para um sistema reutilizável, a formatação é apenas a primeira camada. Um modelo de nota diária, fluxo de captura rápida, revisão semanal e visualização de tarefas facilitam agir com base nas notas. O Obsibrain adiciona esses fluxos de planejamento e gerenciamento de tarefas no Obsidian.

Referências oficiais

• Sintaxe de formatação básica
• Sintaxe de formatação avançada
• Obsidian Flavored Markdown
• Atalhos de edição
• Atalhos de teclado
• Callouts

Continue com links no Obsidian, callouts ou gerenciamento de tarefas.