快速开始

Tydora 是一款基于 Tauri v2 + React 19 构建的现代化桌面 Markdown 编辑器，支持 WYSIWYG 即时渲染、源码双模式编辑、WikiLink 双向链接、知识图谱、思维导图、白板画布等功能。本页带你从安装到写下第一篇笔记，约 5 分钟上手。

如果你已经在用 Obsidian 或 Typora，会发现 Tydora 的很多交互十分熟悉：仓库（Vault）概念、双链语法、即时渲染编辑，都与它们一脉相承。

一、安装

  1. 打开 GitHub Releases 页面。
  2. 根据你的系统下载对应的安装包：
    • Windows：Tydora_x.x.x_x64-setup.exe
    • macOS：Tydora_aarch64.app.tar.gz（Apple 芯片）或 Tydora_x64.app.tar.gz（Intel）
    • Linux：Tydora_amd64.AppImage
  3. 运行安装程序，按提示完成安装。
  4. 启动 Tydora。
首次启动后，Tydora 会检查是否有可用更新（详见 中的「检查更新」）。你也可以随时在设置中手动检查。

二、打开仓库

Tydora 使用「仓库（Vault）」概念来管理你的笔记文件。每个仓库对应本地的一个文件夹，仓库里的所有 Markdown 文件都会被纳入文件树、链接索引与知识图谱。

  1. 点击左侧边栏底部的仓库切换器（通常显示当前仓库名）。
  2. 选择「添加仓库」。
  3. 在系统文件选择器中，挑选一个文件夹作为你的笔记仓库（也可以新建一个空文件夹）。
  4. 确认后，左侧边栏会立即显示该文件夹的文件树。
仓库仅记录文件夹路径，不会移动或复制你的文件。你可以随时添加多个仓库，按项目或主题分别管理。详见 。

三、创建你的第一篇笔记

  1. 在左侧文件树中，右键点击目标文件夹（或根目录）。
  2. 选择「新建文件」。
  3. 输入文件名，例如 我的第一篇笔记.md（.md 后缀可省略，Tydora 会自动补上）。
  4. 按 Enter 确认，编辑器即打开该文件。
  5. 开始用 Markdown 写作吧！
在文件树空白处右键也可「新建文件夹」，先把笔记分类存放，知识才不会变成一团乱麻。

四、基本编辑

Tydora 提供两种编辑模式，满足不同场景：

  • 即时渲染（IR / WYSIWYG）：直接在编辑器里看到最终效果，所见即所得，适合日常写作。
  • 源码模式（SV）：显示纯 Markdown 文本，由 CodeMirror 6 提供语法高亮，适合精细调整格式。

按 Ctrl+/ 可在两种模式间随时切换。详见 02-编辑器/01-编辑模式。

五、保存文件

  • 手动保存：按 Ctrl+S。
  • 自动保存：在 07-设置/01-通用设置 中开启「自动保存」后，文件会在你停止输入约 1 秒后自动写入磁盘。
删除文件不可撤销，请谨慎操作。重要笔记建议先备份，或纳入版本管理（如 Git）。

六、快速导航

熟悉这几个快捷键，能大幅提升使用效率：

快捷键 功能
Ctrl+O 05-导航与搜索/01-快速打开 文件
Ctrl+P 05-导航与搜索/02-命令面板 搜索并执行命令
Ctrl+\ 切换左侧边栏显示/隐藏
Ctrl+/ 切换编辑模式（IR ↔ SV）
Ctrl+G 打开 03-知识管理/04-知识图谱
Ctrl+M 打开 08-高级功能/02-思维导图

完整列表见 07-设置/04-快捷键速查。

七、下一步

写好第一篇笔记后，推荐继续探索：

相关文档