📕 Manual Definitivo do SiYuan: Construindo Seu Cérebro Digital
📕 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ística | O que significa na prática |
|---|---|
| Local-first | Suas notas ficam no seu dispositivo, não dependem da internet para funcionar |
| Blocos modulares | Cada pedaço de texto, imagem ou lista é uma peça separada que pode ser movida |
| Referências bidirecionais | Quando você conecta dois blocos, ambos "sabem" que estão conectados |
| Markdown WYSIWYG | Você escreve em Markdown (código simples) mas vê o resultado formatado instantaneamente |
| Criptografia E2E | Mesmo 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
- Clique com botão direito na "Árvore de Documentos" → "Novo Documento"
- Dê um nome ao seu documento (ex: "Planejamento Semanal")
- Dentro do documento, use:
#para títulos grandes##para subtítulos-para listas com pontos1.para listas numeradas**texto**para negrito*texto*para itálico
⌨️ Atalhos Essenciais no Windows
| Atalho | O que faz |
|---|---|
Ctrl + N | Criar novo documento |
Ctrl + S | Salvar (geralmente automático) |
Ctrl + / | Abrir menu de formatação rápida |
Ctrl + Shift + G | Ativar 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:
| Ícone | Categoria | O que você configura |
|---|---|---|
| ✏️ | Editor | Como o texto aparece e se comporta |
| 📑 | Árvore de Documentos | Como seus cadernos são organizados |
| ⚡ | Cartão de Memo | Sistema de flashcards (repetição espaçada) |
| ✨ | AI | Integração com inteligência artificial |
| 🖼️ | Ativos | Imagens e anexos |
| 📤 | Exportar | Como exportar suas notas |
| 🎨 | Aparência | Temas, cores, fontes |
| 🏪 | Mercado | Plugins e temas adicionais |
| 🔍 | Pesquisar | Configurações de busca |
| ⌨️ | Mapa de Teclas | Atalhos de teclado (para tablets) |
| 👤 | Conta | Sua conta e credenciais |
| ☁️ | Nuvem | Sincronização |
| 🌐 | Publicar | Publicar na web |
| ℹ️ | Sobre | Informaçõ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+Gpara ativar - Verificação Ortográfica ⚪ (Desativado): Corretor automático
- Clique no ponto da lista para focar ⚪ (Desativado)
Configurações de Código e Links:
- 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:
| Campo | Valor Padrão | O que significa |
|---|---|---|
| Modo de revisão | Misturar novos e antigos | Novos e velhos cartões aparecem intercalados |
| Limite de Cartões Novos | 20 | Máximo de novos cartões por sessão |
| Limite de Cartões Antigos | 200 | Revisões pendentes por sessão |
| Retenção FSRS | 0,9 | 90% de chance de lembrar (recomendado) |
| Intervalo Máximo | 36500 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):
| Campo | Descrição | Exemplo |
|---|---|---|
| Provedor da API | Serviço de IA usado | OpenAI (padrão) |
| Tempo limite | Segundos para a API responder | 30s |
| Temperatura | Criatividade das respostas (0-2) | 1 (equilibrado) |
| Modelo | Modelo de IA específico | gpt-3.5-turbo |
| Chave API | Sua chave pessoal da OpenAI | Campo seguro |
| URL base | Endereço do serviço | https://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:
| Ferramenta | Para que serve |
|---|---|
| Otimizar Índice | Libera espaço e melhora velocidade |
| Reconstruir Índice | Recria tudo do zero (demora, mas limpa) |
| Limpar Repositório | Remove snapshots antigos |
| Exportar Log | Pega 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étodo | Como funciona | Melhor para |
|---|---|---|
| Liuyun | Serviço oficial do SiYuan | Iniciantes (mais fácil) |
| S3 | Amazon S3 ou compatível | Usuários avançados |
| WebDAV | Seu próprio servidor | Total controle |
🛡️ Sua Privacidade é Protegida
- Criptografia de ponta a ponta: Seus dados são embaralhados antes de sair do seu dispositivo
- Somente você tem a chave: Nem mesmo o SiYuan consegue ler suas notas
- 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:
- Escreva a informação uma vez em um bloco
- Use
[[para referenciar esse bloco em outros lugares - Quando editar o bloco original, todas as referências atualizam
Resultado: Menos duplicação, mais conexões!
✅ Prática 3: Flashcards para Aprendizado Ativo
- Enquanto estuda, marque conceitos com
==texto== - No dia seguinte, use Cartão de Memo para revisar
- 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:
- Vá em Configurações → Nuvem
- Ative sincronização em segundo plano
- Periodicamente, verifique Configurações → Sobre → Otimizar Índice
📊 Resumo Visual: Suas Ferramentas no Android
| O que você quer fazer | Onde ir | O que tocar |
|---|---|---|
| Escrever uma nota | Tela inicial | Toque em "+" ou documento |
| Configurar editor | ⚙️ → Editor | Toggle switches |
| Estudar flashcards | ⚙️ → Cartão de Memo | Iniciar revisão |
| Usar IA (ChatGPT) | ⚙️ → AI | Preencha 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