📕 Manual Definitivo do SiYuan: Construindo Seu Cérebro Digital


1. O que é o SiYuan? (Explicado para Leigos)

Imagine que você tem um cofre pessoal no seu celular e computador — um lugar onde todas as suas ideias, anotações e pensamentos ficam guardados exclusivamente em seus aparelhos, sem ninguém na nuvem bisbilhotando. Isso é o SiYuan: um sistema de gerenciamento de conhecimento que prioriza sua privacidade acima de tudo. Suas notas vivem primeiro no seu dispositivo (local-first) e só vão para a nuvem quando você decidir — e ainda assim, são criptografadas de ponta a ponta, como uma carta selada que só você pode abrir .

Agora, pense em cada parágrafo, imagem ou tabela dentro de uma nota como uma peça de Lego. No SiYuan, cada "peça" (chamada de Bloco) existe independentemente. Você pode mover um parágrafo inteiro com um clique, copiar uma citação para outro documento, ou criar conexões entre blocos que parecem mágica — como uma teia de aranha mental onde cada fio puxa informações relacionadas automaticamente .

🌟 Por que o SiYuan é diferente?

CaracterísticaO que significa na prática
Local-firstSuas notas ficam no seu dispositivo, não dependem da internet para funcionar
Blocos modularesCada pedaço de texto, imagem ou lista é uma peça separada que pode ser movida
Referências bidirecionaisQuando você conecta dois blocos, ambos "sabem" que estão conectados
Markdown WYSIWYGVocê escreve em Markdown (código simples) mas vê o resultado formatado instantaneamente
Criptografia E2EMesmo que seus dados vão para a nuvem, ninguém consegue ler (nem o SiYuan)

2. Visão Geral no Computador (Windows 11)

🎛️ A Interface do Windows

Ao abrir o SiYuan no seu PC, você encontra uma estrutura organizada em três áreas principais:

┌─────────────────────────────────────────────────────────────┐
│  [siyuan ▼]  [←][→]     siyuan - SiYuan v3.6.4      [☁️][📑][🔍][☀️][⏻] │
├──────────────┬──────────────────────────────────────────────┤
│              │                                              │
│  ÁRVORE DE   │         ÁREA DE TRABALHO                    │
│  DOCUMENTOS  │                                              │
│              │   Aqui você escreve, edita e                  │
│  📁 Trabalho │   visualiza suas notas em                    │
│  📁 Estudos  │   formato rico                               │
│  📁 Pessoal  │                                              │
│              │                                              │
├──────────────┴──────────────────────────────────────────────┤
│  > Blocos de notas fechados: 5                    [📐]     │
└─────────────────────────────────────────────────────────────┘

Barra Superior (Menu):

  • siyuan ▼: Menu suspenso para configurações rápidas
  • Setas ← →: Voltar e avançar entre páginas (como no navegador)
  • Ícones da direita: Sincronização (nuvem), Layout, Pesquisa, Tema claro/escuro, Sair

📝 Criando Cadernos e Documentos

  1. Clique com botão direito na "Árvore de Documentos" → "Novo Documento"
  2. Dê um nome ao seu documento (ex: "Planejamento Semanal")
  3. Dentro do documento, use:
    • # para títulos grandes
    • ## para subtítulos
    • - para listas com pontos
    • 1. para listas numeradas
    • **texto** para negrito
    • *texto* para itálico

⌨️ Atalhos Essenciais no Windows

AtalhoO que faz
Ctrl + NCriar novo documento
Ctrl + SSalvar (geralmente automático)
Ctrl + /Abrir menu de formatação rápida
Ctrl + Shift + GAtivar modo somente leitura
[[Criar link para outro documento/bloco

💡 Exemplo Prático: Organizando Estudos

Imagine que você está estudando para uma prova de História:

📁 Estudos
├── 📄 Revisão Idade Média
│   ├── [Bloco: Conceitos importantes] → Referências para flashcards
│   ├── [Bloco: Linhas do tempo] → Conectado a "Cronologia Geral"
│   └── [Bloco: Mapas mentais] → Blocos visuais
└── 📄 Perguntas Frequentes
    └── Cada pergunta puxa a resposta do documento certo

3. Dominando o SiYuan no Android (Mobile & Tablet)

Esta é a seção mais importante do manual! Baseado nas capturas de tela do seu dispositivo Android, vou explicar cada tela em detalhes.


📱 Tela 1: Menu de Configurações do Editor (Imagens 1-4)

As primeiras capturas mostram a janela de Configurações do SiYuan, acessível pelo ícone de engrenagem:

Menu Lateral Esquerdo — Navegue entre categorias:

ÍconeCategoriaO que você configura
✏️EditorComo o texto aparece e se comporta
📑Árvore de DocumentosComo seus cadernos são organizados
Cartão de MemoSistema de flashcards (repetição espaçada)
AIIntegração com inteligência artificial
🖼️AtivosImagens e anexos
📤ExportarComo exportar suas notas
🎨AparênciaTemas, cores, fontes
🏪MercadoPlugins e temas adicionais
🔍PesquisarConfigurações de busca
⌨️Mapa de TeclasAtalhos de teclado (para tablets)
👤ContaSua conta e credenciais
☁️NuvemSincronização
🌐PublicarPublicar na web
ℹ️SobreInformações do sistema

⚙️ Seção Editor — Configurações Detalhadas (Imagens 1-4)

Na aba Editor, você encontra:

Display e Visualização:

  • Largura Adaptável 🔵 (Ativado): A área de edição ocupa o máximo possível da tela
  • Justificar 🔵 (Ativado): Texto alinhado dos dois lados
  • Direita para Esquerda (RTL) ⚪ (Desativado): Para idiomas como árabe
  • Ícone de canto do bloco ⚪ (Desativado): Mostra marcadores nos blocos

Comportamento do Editor:

  • Modo somente leitura ⚪ (Desativado): Pressione Ctrl+Shift+G para ativar
  • Verificação Ortográfica ⚪ (Desativado): Corretor automático
  • Clique no ponto da lista para focar ⚪ (Desativado)
  • Quebra de linha do bloco de código 🔵 (Ativado): Código longo quebra automaticamente
  • Converter automaticamente URL colada em link ⚪ (Desativado)
  • Referência Virtual ⚪ (Desativado): Destaca automaticamente relações entre blocos

Dica: Mantenha o Modo Sombreado (Ctrl+Shift+G) desativado no celular para evitar toques acidentais.


🧠 Sistema de Flashcards — Repetição Espaçada (Imagem 5)

A seção Cartão de Memo é um sistema de aprendizado inteligente:

Opções de Geração de Cartões:

  • Marcar Cartão 🔵 (Ativado): Use ==texto== para criar cartas
  • Listar Cartão 🔵 (Ativado): Primeira linha = pergunta, resto = resposta
  • Bloco de Título Cartão 🔵 (Ativado): Título = pergunta
  • Super Bloco Cartão 🔵 (Ativado): Primeiro bloco filho = pergunta

Configurações de Revisão:

CampoValor PadrãoO que significa
Modo de revisãoMisturar novos e antigosNovos e velhos cartões aparecem intercalados
Limite de Cartões Novos20Máximo de novos cartões por sessão
Limite de Cartões Antigos200Revisões pendentes por sessão
Retenção FSRS0,990% de chance de lembrar (recomendado)
Intervalo Máximo36500 dias~100 anos de espaçamento máximo

🤖 Configurações de Inteligência Artificial (Imagens 6-7)

Na seção AI, você configura integração com OpenAI (ChatGPT):

CampoDescriçãoExemplo
Provedor da APIServiço de IA usadoOpenAI (padrão)
Tempo limiteSegundos para a API responder30s
TemperaturaCriatividade das respostas (0-2)1 (equilibrado)
ModeloModelo de IA específicogpt-3.5-turbo
Chave APISua chave pessoal da OpenAICampo seguro
URL baseEndereço do serviçohttps://api.openai.com/v1

⚠️ Importante: A Chave API é como uma senha — mantenha-a segura e não compartilhe!


🔧 Seção Sistema e Manutenção (Imagens 8-10)

A aba Sobre contém ferramentas importantes:

Acesso ao Navegador

  • Código de Autorização: Senha para acessar via navegador Chrome na mesma rede
  • Endereços de acesso:
    • http://192.168.2.51:6806 (rede local)
    • http://127.0.0.1:6806 (este dispositivo)

Manutenção do Banco de Dados:

FerramentaPara que serve
Otimizar ÍndiceLibera espaço e melhora velocidade
Reconstruir ÍndiceRecria tudo do zero (demora, mas limpa)
Limpar RepositórioRemove snapshots antigos
Exportar LogPega registros para diagnóstico

Chave do Repositório de Dados:

  • Crucial para sincronização: Todos os dispositivos DEVEM usar a mesma chave
  • Se as chaves forem diferentes → dados não sincronizam na nuvem

🎨 Navegação e Interface Principal

Barra Superior (sempre visível):

  • siyuan ▼: Menu principal do app
  • ← →: Botões de navegação entre páginas
  • ☁️: Sincronizar com a nuvem
  • 📐: Alternar layout de painéis
  • 🔍: Pesquisa global
  • ☀️/🌙: Alternar tema claro/escuro
  • : Fechar/sair

Barra Inferior:

  • "Blocos de notas fechados: 5" — Quantos cadernos estão minimizados
  • Ícone de layout — Alternar entre painéis

4. A Mágica da Sincronização e Privacidade (Windows 11 ↔ Android)

🔐 Como a Sincronização Funciona?

O SiYuan usa um conceito chamado "Local-First, Sync-When-Ready" (Local Primeiro, Sincronize Quando Pronto):

┌─────────────────┐         ☁️ Nuvem         ┌─────────────────┐
│                 │    (Liuyun/S3/WebDAV)    │                 │
│  💻 Windows 11  │ ←──── Criptografado ──→  │  📱 Android     │
│                 │                          │                 │
│  Seus dados:    │    Chaves iguais?        │  Seus dados:    │
│  • Cadernos    │    → Sincroniza!         │  • Cadernos     │
│  • Blocos      │    → Sem erro!           │  • Blocos       │
│  • Configs     │                          │  • Configs      │
└─────────────────┘                          └─────────────────┘

📋 Tipos de Sincronização

MétodoComo funcionaMelhor para
LiuyunServiço oficial do SiYuanIniciantes (mais fácil)
S3Amazon S3 ou compatívelUsuários avançados
WebDAVSeu próprio servidorTotal controle

🛡️ Sua Privacidade é Protegida

  1. Criptografia de ponta a ponta: Seus dados são embaralhados antes de sair do seu dispositivo
  2. Somente você tem a chave: Nem mesmo o SiYuan consegue ler suas notas
  3. Funciona offline: Escreva sem internet; sincronize depois

⚠️ Regra de Ouro da Chave

Se você usa múltiplos dispositivos, TODOS devem ter a MESMA chave de repositório de dados! Se um dispositivo tiver chave diferente, ele não conseguirá sincronizar e可能导致 perda de dados.


5. Melhores Práticas e Hábitos de Ouro

✅ Prática 1: Estrutura de Pastas Inteligente

No Windows, crie uma hierarquia lógica:

📁 Meu Cérebro Digital
├── 📁 Projetos (trabalho, estudos)
│   ├── 📁 Relatório 2024
│   └── 📁 TCC
├── 📁 Referências (material de estudo)
│   ├── 📁 Livros
│   └── 📁 Artigos
└── 📁 Área de Captura (ideias rápidas)
    └── 📄 Anotações do dia

No Android: Mantenha a mesma estrutura para não se confundir.


✅ Prática 2: Use Blocos como Escopo de Referência

Em vez de copiar e colar textos entre documentos:

  1. Escreva a informação uma vez em um bloco
  2. Use [[ para referenciar esse bloco em outros lugares
  3. Quando editar o bloco original, todas as referências atualizam

Resultado: Menos duplicação, mais conexões!


✅ Prática 3: Flashcards para Aprendizado Ativo

  1. Enquanto estuda, marque conceitos com ==texto==
  2. No dia seguinte, use Cartão de Memo para revisar
  3. Ajuste os limites (20 novos, 200 antigos) conforme sua disponibilidade

Exemplo:

==data da Revolução Francesa==

Resposta: 14 de julho de 1789

✅ Prática 4: Abraço o Tema Escuro no Celular

Especialmente em tablets Android:

  • Use o tema claro durante o dia ☀️
  • Mude para tema escuro à noite 🌙
  • Acesse pelo ícone de sol na barra superior

✅ Prática 5: Backup Regular no Celular

No Android, configure sincronização automática:

  1. Vá em Configurações → Nuvem
  2. Ative sincronização em segundo plano
  3. Periodicamente, verifique Configurações → Sobre → Otimizar Índice

📊 Resumo Visual: Suas Ferramentas no Android

O que você quer fazerOnde irO que tocar
Escrever uma notaTela inicialToque em "+" ou documento
Configurar editor⚙️ → EditorToggle switches
Estudar flashcards⚙️ → Cartão de MemoIniciar revisão
Usar IA (ChatGPT)⚙️ → AIPreencha chave API
Acessar via navegador⚙️ → Sobre"Abrir navegador"
Sincronizar☁️ (ícone)Toque rápido

🎓 Conclusão: Seu Cérebro Digital, Suas Regras

O SiYuan não é apenas um aplicativo de notas — é um segundo cérebro que:

  • ✅ Mantém seus dados privados e seguros
  • ✅ Organiza pensamentos em blocos reutilizáveis
  • ✅ Conecta ideias automaticamente
  • ✅ Funciona offline quando precisar
  • ✅ Sincroniza criptografado quando puder

Comece devagar: Crie um caderno, escreva algumas notas, explore os blocos. Em pouco tempo, você estará construindo uma rede de conhecimento que cresce com você! 🚀


Versão do Manual: Baseado no SiYuan v3.6.4 Atualizado em: Abril 2026

Built with LogoFlowershow