O Guia Completo de Notas em Markdown

O Markdown é o melhor formato de escrita que provavelmente está a subutilizar. É texto simples que renderiza de forma bonita, é rápido de escrever quando aprende os atalhos, e mantém as suas notas legíveis mesmo como texto simples.

Este guia cobre tudo o que precisa para transformar as suas notas de texto não estruturado em documentos organizados e formatados.

---

O que é Markdown?

Markdown é uma linguagem de marcação leve criada por John Gruber em 2004. A ideia: escrever usando convenções simples de pontuação que são legíveis como texto simples e renderizam em HTML formatado.

Em vez de clicar em Negrito numa barra de ferramentas, envolve o texto em **asteriscos**. Em vez de um botão de título, coloca ## no início de uma linha. Nunca precisa de tirar as mãos do teclado.

---

A sintaxe essencial do Markdown

Títulos

Use símbolos # para títulos. Um # para o título principal, ## para secções, ### para sub-secções.

# Notas de Reunião — Planeamento Q1
## Ações a tomar
### Equipa de design

Regra geral: Use um H1 por nota (o título), H2 para secções principais, H3 para sub-tópicos.

Negrito e itálico

**Texto a negrito** — para termos, avisos, pontos-chave
*Texto em itálico* — para ênfase, títulos, palavras estrangeiras
***Negrito e itálico*** — use com moderação

Listas

Listas não ordenadas — use - ou *:

- Primeiro item
- Segundo item
  - Item aninhado (indente com 2 espaços)
  - Outro item aninhado
- Voltar ao nível superior

Listas ordenadas — basta usar números:

1. Abrir o Krokanti Notes
2. Criar uma nova nota
3. Começar a escrever

Listas de verificação

- [x] Item concluído
- [ ] Item pendente
- [ ] Outro item pendente

No Krokanti Notes, estas renderizam como caixas de seleção interativas que pode clicar para completar.

Código

O código inline usa crases simples:

Use `npm install` para instalar dependências.

Os blocos de código usam crases triplas:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

Especifique sempre a linguagem para uma formatação adequada.

Citações

> A melhor nota é aquela que consegue encontrar quando precisa.

Use citações para frases, destaques importantes ou conclusões principais.

Links

[Texto âncora](https://exemplo.com)

Tabelas

| Coluna 1 | Coluna 2 | Coluna 3 |
|----------|----------|----------|
| Célula A | Célula B | Célula C |
| Célula D | Célula E | Célula F |

As tabelas são perfeitas para comparações, horários e dados estruturados.

---

Padrões de notas em Markdown

O modelo de nota de reunião

# Reunião: [Tema] — [Data]
**Participantes:** Alice, Bob, Carol
**Objetivo:** [O que está a tentar decidir ou realizar]

## Decisões tomadas
- [Decisão 1]
- [Decisão 2]

## Ações a tomar
- [ ] @Alice — [Tarefa] até [data]
- [ ] @Bob — [Tarefa] até [data]

## Notas
[Notas livres da discussão]

## Próxima reunião
[Data, tema]

O modelo de nota de investigação

# Investigação sobre [Tema]

## Fontes principais
- [Fonte 1](link) — [resumo numa linha]
- [Fonte 2](link) — [resumo numa linha]

## Principais conclusões
### Conclusão 1: [Título]
[Detalhes]

### Conclusão 2: [Título]
[Detalhes]

## A minha síntese
[A sua própria perspetiva, ligando as conclusões]

## Questões em aberto
- [ ] [Questão a investigar mais]

O modelo de nota diária

# [Data]

## Foco de hoje
1. [Prioridade principal]
2. [Segunda prioridade]

## Notas
[Tudo o que foi capturado durante o dia]

## Feito
- [x] [Tarefas concluídas]

## Amanhã
- [ ] [Transferências]

---

Markdown no Krokanti Notes

O Krokanti Notes usa o Tiptap, um dos editores open-source mais capazes, com suporte completo de Markdown:

• Toda a sintaxe Markdown padrão renderiza enquanto escreve
• As listas de verificação são interativas (clique para marcar/desmarcar)
• Os blocos de código preservam a formatação e o tipo de letra monospace
• As tabelas são editáveis inline — clique em qualquer célula para editar

Pode escrever em Markdown e o Krokanti Notes trata da renderização automaticamente. Sem necessidade de painel de pré-visualização.

---

Dicas avançadas

Use títulos como âncoras de pesquisa

Se escrever bons títulos, pode pesquisar pelo nome da secção e saltar diretamente para a parte certa de qualquer nota. "decisões de reunião" encontra todas as notas com uma secção ## Decisões tomadas ou similar.

Etiquete por tópico, não por data

É tentador nomear as notas por data: 2025-01-20 notas de reunião. Mas pesquisar por data raramente é útil. Em vez disso, use títulos descritivos e etiquetas:

Título: Planeamento Q1 — Ações a Tomar Etiquetas: #q1, #planeamento, #engenharia

Mantenha uma nota de "rascunho"

Tenha uma nota chamada "Rascunho" ou "Caixa de entrada" para capturar pensamentos imediatamente. Processe-a no final de cada dia — mova as coisas para as suas notas adequadas, apague o que foi inútil.

Use citações para as conclusões principais

No final de uma nota longa, resuma o ponto mais importante numa citação:

> Resumo: Decidimos usar Postgres para a base de dados principal e Redis para as sessões. Rever a estratégia de cache no Q2.

---

Perguntas frequentes

O Markdown é difícil de aprender? O básico demora cerca de 15 minutos a aprender. Os padrões neste guia cobrem 95% de tudo o que precisará para as suas notas.

Posso usar Markdown no Krokanti Notes no telemóvel? Sim — o Krokanti Notes funciona em qualquer browser móvel. O Markdown renderiza no telemóvel da mesma forma que no computador.

O Krokanti Notes suporta toda a sintaxe Markdown? O Krokanti Notes suporta todo o Markdown CommonMark mais extensões: tabelas, listas de verificação (GFM) e blocos de código com indicações de linguagem.

E se não quiser usar Markdown? O Krokanti Notes é também um excelente editor de texto simples. Não tem de usar Markdown de todo — basta escrever prosa e ficará limpo e legível.

---

Veja também: Notas para programadores · Primeiros passos com o Krokanti Notes · Visão geral das funcionalidades