O Logseq é uma aplicação avançada de anotações e gestão do conhecimento, projetada para usuários que valorizam organização semântica, vinculação entre blocos e compatibilidade com padrões abertos. Embora suporte Markdown, sua modelagem baseada em blocos — inspirada no Org-mode — exige atenção especial à formatação. Este guia explica como aplicar estilos de texto, inserir citações, criar chamadas de atenção (admonition blocks) e garantir compatibilidade entre ambientes.

basic-markdown-samples

Pré-requisitos

Sistema operacional Linux, macOS ou Windows
Logseq instalado na versão mais recente (baixe aqui)
Conhecimento básico de Markdown (não é necessário dominar Org-mode)
Projeto pessoal ou workspace criado no Logseq

Como usar a formatação básica de Markdown no Logseq

O Logseq interpreta corretamente a sintaxe padrão de Markdown para elementos essenciais. Isso garante portabilidade mínima ao exportar notas para outros editores ou geradores estáticos.

# Título nível 1

## Título nível 2

### Título nível 3

[Link para documentação oficial](https://logseq.com)

![Ícone do Logseq](./assets/logseq-icon.png)

**Texto em negrito**  
*Texto em itálico*  
~~Texto riscado~~  
`código embutido`

bloco de código com múltiplas linhas


| Coluna A | Coluna B |
|----------|----------|
| Dado 1   | Valor 1  |
| Dado 2   | Valor 2  |

Esses elementos são renderizados conforme esperado ao visualizar a página no Logseq. A vantagem é que arquivos .md produzidos assim permanecem válidos em qualquer leitor Markdown — inclusive no GitHub, Obsidian ou Joplin.

💡 Dica rápida: pressione / em qualquer bloco vazio para abrir um menu contextual com todas as opções de formatação disponíveis.

Como inserir citações com duas abordagens

O Logseq oferece duas formas de adicionar blocos de citação: uma compatível com Markdown puro e outra com sintaxe Org-mode. A escolha depende do objetivo de portabilidade.

Método 1 — Markdown puro (recomendado para compatibilidade)
Use o caractere > no início do bloco:

> Esta é uma citação que será renderizada corretamente em qualquer ambiente Markdown.

Esse formato funciona em todos os leitores de Markdown, incluindo GitHub, VS Code e ferramentas de conversão automática (como pandoc).

Método 2 — Sintaxe Org-mode (funcionalidade exclusiva do Logseq)
Use delimitadores específicos:

#+BEGIN_QUOTE
Esta citação só funciona no Logseq e em outros leitores que suportam Org-mode.
#+END_QUOTE

Para inserir rapidamente esse bloco, pressione <, digite Quote e confirme com Enter.

⚠️ Atenção: blocos com #+BEGIN_QUOTE não são interpretados por editores Markdown genéricos — use apenas se sua workflow for totalmente centrada no Logseq.

Como adicionar chamadas de atenção (admonition blocks)

Admonition blocks (ou callouts) permitem destacar informações críticas, dicas, advertências ou observações importantes dentro de uma nota. São recursos nativos do Logseq — não fazem parte do padrão Markdown, nem do Org-mode clássico.

A sintaxe segue o padrão Org-mode adaptado:

#+BEGIN_TIP
Use este bloco para compartilhar atalhos úteis ou boas práticas.
#+END_TIP

#+BEGIN_WARNING
Cuidado ao executar scripts não verificados em seu sistema.
#+END_WARNING

#+BEGIN_NOTE
Este bloco serve para observações complementares.
#+END_NOTE

Blocos suportados oficialmente pelo Logseq incluem: TIP, NOTE, WARNING, CAUTION, IMPORTANT e PINNED.

Para inseri-los rapidamente, pressione <, digite o nome do bloco (ex: Tip) e selecione na lista.

⚠️ Solução de problemas comum:
Se um bloco não aparecer formatado, verifique se há espaços extras antes ou depois dos delimitadores #+BEGIN_... e #+END_.... O Logseq exige que essas linhas estejam limpas — sem indentação ou caracteres invisíveis.

Como confirmar que a formatação funcionou

Salve o arquivo com extensão .md ou .org
Recarregue a página no Logseq (ou navegue para ela)
Verifique visualmente se:
- Cabeçalhos aparecem com hierarquia correta
- Links e imagens são clicáveis/visualizáveis
- Blocos de citação e admonitions exibem bordas e ícones distintos
Exporte o arquivo como HTML via menu Export → HTML e abra no navegador para testar compatibilidade externa

Blocos criados com sintaxe Org-mode (#+BEGIN_*) serão preservados apenas no Logseq. Já elementos Markdown puros (>, **, ```) mantêm funcionalidade em qualquer ambiente compatível.

Para explorar mais recursos avançados, como referências bidirecionais, queries e templates, acompanhe a próxima parte da série no It's FOSS.