快速上手

更新日期：2026-09-07

本页带你从安装到第一次真正的工作：打开或新建仓库、认识界面，以及理解三种编辑器模式。

系统要求

Plainva 用系统自带的网页引擎绘制窗口，所以决定下限的是引擎，而不是处理器：

• Windows 10 或更高版本，并安装 WebView2 运行时（Windows 11 已自带；在 10 上由安装程序添加）
• macOS 13.3（Ventura） 或更高版本，Apple Silicon 或 Intel 均可
• Linux 需 WebKitGTK 2.40 或更高版本（可用 pkg-config --modversion webkit2gtk-4.1 查看）

引擎的下限是 Safari 16.4，而在 macOS 上，决定这个下限的是系统版本：应用是用系统自带的 WebView 绘制窗口的，而这个 WebView 会随 macOS 更新而更新，并不会随 Safari 更新。因此，在 Apple 已经不再更新的 Mac 上，Safari 可能比其他任何应用所获得的引擎新得多——无论 Safari 本身多新，Monterey 上的引擎都停留在 Safari 15.6.1。Ventura 在 13.3 版本时达到了 16.4，下限就设在这里；安装更新的 Safari 并不会改变这个下限。

在低于该下限的系统上，Plainva 会在启动时明确告知，而不是打开一个空白窗口。

Linux：选择哪个文件。 在 Fedora、openSUSE 等基于 RPM 的发行版上安装 .rpm，在 Debian 和 Ubuntu 上安装 .deb——两者都使用系统自带的 WebKitGTK、Mesa 和 Wayland 库。.AppImage 是没有软件包的发行版的备用方案：它自带部分库的副本，在非常新的系统上（Mesa 25 或更高版本），这些副本可能与主机的图形栈发生冲突。0.8.0 之后构建的 AppImage 在启动时会规避这个问题；如果窗口仍然显示空白，请从终端启动它并查看提示信息——EGL_BAD_PARAMETER 正是指向这个问题，.rpm 或 .deb 就是绕开它的办法。NVIDIA 显卡上出现空白窗口则是另一回事：可以尝试 WEBKIT_DISABLE_DMABUF_RENDERER=1 ./Plainva*.AppImage（这是 WebKitGTK 的一项设置，参见 Tauri 关于 Linux 图形的说明）。

什么是仓库？

仓库就是电脑上一个存放Markdown笔记的普通文件夹。Plainva会添加一个隐藏的.plainva/子文件夹，用来存放搜索索引和设置——你的笔记本身仍然是未被改动的.md文件。你可以拥有多个仓库（例如”个人”和”工作”），并在它们之间切换。

打开或新建仓库

首次启动——也就是你还从未打开过任何仓库时——Plainva会一次性显示一段简短的欢迎提示。它用三行文字说明Plainva的基础，旁边展示界面的小预览，并直接提供三种进入方式：打开仓库、新建仓库和从其他应用导入。点击稍后会跳过它，把你带到平时的欢迎界面；它不会再出现——除非你在设置 → 启动与行为 → 欢迎界面中再次调出它。

更新后，同一位置会显示发生了哪些变化：该版本中最重要的变化会单独配有标题，其余各占一行。它每个版本只出现一次——你可以随时在设置 → 启动与行为 → 再次显示版本新功能中再次调出它。

启动时，欢迎界面会显示：

• 打开仓库——Plainva会先问”你的仓库在哪里？“：本地文件夹用于打开这台电脑上一个已有的Markdown文件夹（Obsidian仓库可以直接使用）；在线仓库会把云端已有的仓库同步到一个本地文件夹——每个服务商都遵循相同的三个步骤（连接、选择云端文件夹、选择或创建本地文件夹；参见设置同步）。
• 新建仓库——首先会问”你的仓库要放在哪里？“（在这台电脑上或在在线服务中），然后选择起始结构：从空白开始，或使用预设的文件夹结构；两者随时都可以调整。空仓库只包含一个index.md概览。可用的模板有：Plainva导览、PARA、Zettelkasten、ACE (Linking Your Thinking)、Johnny.Decimal、GTD、Journal和项目——每一种都会创建文件夹、一篇带快速指南的欢迎笔记，以及以OKF格式自动维护的index.md概览（文件夹和文件名称跟随应用语言）。Plainva导览是推荐的起点：它用示例填充了九个文件夹和七个数据库，让你一次性看到每种视图的实际效果——便签板、日历、画廊、看板、时间轴、表格，以及带子项的树形视图——此外还配有笔记模板、文件夹规则和一份Markdown速查表。这里没有什么是碰不得的：删除你不需要的内容，把剩下的重命名即可。Journal模板还会额外配置好仓库的日记设置。Plainva导览、PARA、GTD、Zettelkasten、Journal和项目模板还会附带已经关联好的数据库以及配套的笔记模板——例如带有状态看板和领域关联的项目，或指向所属项目的任务。项目模板展示了项目工具的实际运作：四个相互关联的数据库、一列统计项目未完成任务数、一个列脚汇总计划工时、任务之间的依赖关系，以及在时间轴上显示为菱形的里程碑。在线路径下，连接会紧接着结构进行：选择服务商、连接、选择云端文件夹或通过新建文件夹新建一个，再选择本地文件夹——所选结构会被创建在本地文件夹中，并在首次同步时上传到云端。

最近使用的仓库列出了你之前打开过的所有仓库。从列表中移除只会从Plainva中移除该条目——文件仍保留在磁盘上。启用启动时自动打开上次的仓库可以在以后跳过欢迎界面。移除时，Plainva 会询问是否同时清除该仓库的所有应用数据（搜索索引、设置、窗口布局、同步、日历和邮箱的凭据；自动 ZIP 备份仅通过额外的复选框删除）——你的仓库文件夹在任何情况下都不受影响。

界面介绍

• 左侧边栏——三个视图：文件（文件树）、标签（仓库中所有的#标签）和数据库（仓库中所有的.base，按文件夹分组——点击即可打开）；最近打开和书签是视图切换器上方的两个区域，因此在三个视图中都保持可见。最顶部是搜索框，旁边带一个**+，用于新建笔记、新建文件夹、新建数据库和日记。搜索框的占位提示文字会说明当前搜索的是什么，只要面板足够宽，标签页就会显示各自的名称——随着面板变窄，先是只有当前激活的标签页保留名称，最后就只剩下图标。底部是仓库切换器、打开日记和设置**。三个视图旁边的双箭头按钮可一键折叠或展开所有文件夹；编辑器 ⋮ 菜单中的 在文件树中显示 会直接在文件树中定位当前笔记。在文件视图中，顶部会显示当前仓库的名称和图标。
• 排序 — 搜索框旁的按钮可按 标题、最近修改 或 创建时间 排列文件树；再次选择同一项会反转方向。子文件夹和文件夹的 index.md 始终排在最前；选择会记住在此设备上。
• 标题栏——你打开的标签页。标签页可以通过拖动重新排序，也可以在编辑器窗格之间移动。
• 编辑器区域——你在这里阅读和写作。通过标签页菜单（向右分屏 / 向下分屏）或快捷键Ctrl+Alt+V / Ctrl+Alt+S，可以把编辑器分成两个窗格，例如让一篇笔记和一个数据库并排显示。
• 更多窗口 — 在独立窗口中打开的笔记右侧同样显示上下文侧边栏（大纲、图谱、数据库、反向链接、属性；日历留在主窗口），可在标题栏中折叠和展开。编辑器的 ⋮ 菜单在那里做的事和主窗口一样：版本历史… 和冲突解决会在笔记所在的窗口中打开，在文件树中显示 会把带有文件树的窗口调到前台并选中该文件，右键点击标签页会显示同一个标签页菜单（没有 在新窗口中打开 ——因为这个标签页已经在一个窗口里了）。
• 右侧边栏——四个分区，可拖动调整顺序：日历（日记）、大纲（当前笔记的标题）、反向链接（谁链接到这里）和属性（笔记的Frontmatter）。
• 状态栏——字数/字符数统计、同步状态（本地/在线/离线）和保存状态（保存中… / 已保存）。
• 空列表 — 没有内容的列表会说明它期待什么，并给出第一步：文件树、数据库、图谱、邮件、任务。

三种编辑器模式

在编辑器右上方切换模式：

笔记会以哪种模式打开由你决定：在设置 → 应用 → 编辑器与笔记中选择默认视图（阅读、实时或源码）。在编辑器中手动切换模式，仅对该文件在当前会话内生效。

你也可以在适读宽度和全宽之间切换。

文件树基础

• 新建： 右键点击文件夹→在此处新建笔记、新建文件夹或新建数据库（.base）。大大的新建按钮会在当前选中的文件夹内新建（如果选中的是文件，则在其所在的父文件夹内新建）。
• 选择： 单击选中，Ctrl+单击可单独添加/移除选中项，Shift+单击可选择一个区间，鼠标中键点击会在新标签页中打开。
• 右键菜单： 包括重命名（会更新整个仓库中的链接）、创建副本、分屏打开（右侧） / 分屏打开（下方）、添加书签、复制路径、在文件管理器中显示、删除。
• 右键菜单中的 移动到… 会把笔记、文件夹或整个多选移动到你选择的文件夹——与拖放相同的处理，只是无需拖动：打开的标签页、看板引用和索引都会跟随。
• 文件树上方区域中的相同操作： 右键点击最近打开或书签中的一项会打开同样的菜单——没有文件夹相关的条目，但多了从列表中移除（这只会把该条目从列表中移除，绝不会删除文件）。这里的重命名通过对话框进行，而不是像行内那样使用输入框。日历和任务视图也可以出现在最近打开中；它们可以被打开、从列表中移除，但不能重命名或删除——它们是视图，不是文件。
• 多选： 删除多个项目时只会确认一次，拖动可对整个选中范围进行创建副本和移动操作。被删除的项目会进入操作系统的回收站。
• 新建的笔记会自动以根据文件名生成的# 标题开头。
• 文件夹自己的index.md（该文件夹的概览）在文件树中会排在该文件夹的最上方，位于其子文件夹和文件之上——而不是像其他笔记一样按字母顺序排列。
• 重新读取： 树的标题栏中的圆形箭头（或 F5）会重新读取仓库——Plainva 会将索引与文件夹核对，联网仓库还会额外获取云端文件。之后会显示一份简短的报告，说明有哪些内容是新增、修改、删除或被跳过的。对于单个文件夹，右键菜单中有重新读取此文件夹。

日记

左侧操作栏中的日记按钮会打开或创建今天的笔记。可以在设置 → 仓库 → 内容与结构（点击输入框旁的 选择文件夹… 可直接在仓库中选择文件夹）中配置基础文件夹、日期格式和可选的模板。

日期格式使用与 Obsidian 相同的占位符：YYYY 年、MM 月、DD 日、dddd 星期名——YYYY-MM-DD dddd 得到 2026-07-29 Wednesday。需要原样保留的文字放在方括号里：[日记] YYYY-MM-DD。月份和星期名称始终为英文，这样切换应用语言不会让已有的日记变得无法找到。

右侧的日历是一个按天呈现的概览：点击某个日期会打开日历标签页并定位到该日；右键点击则会打开一个菜单，菜单顶部标明该日期，并提供打开日历、日记以及当天的日程和到期任务。带有日记的日期上会有一个小小的太阳图标，带有日程的日期则按对应日历显示彩色圆点。今天按钮会返回到当前月份；点击月份标签会打开一个快速选择月份和年份的界面。你还可以在那里启用显示周数，以添加一列ISO周数——该设置会被记住。

设置

设置（最左侧操作栏底部的齿轮图标，或Ctrl+,）可以通过右上角的X、Esc键或点击窗口外部关闭。更改会立即自动保存——只有云端凭据需要通过云账户区域中的登录才会生效（参见设置同步）。设置分为两部分；左侧栏中的每个区域都会打开自己的页面，设置以命名的分组卡片形式呈现：

• 应用——适用于全应用范围的一切设置，分为五个区域。外观：主题选择器以预览卡片的形式呈现——除了深青（默认）之外，还有Nord、Solarized、Gruvbox、Catppuccin、纸张（类似电子墨水，格外平静）、深褐（暖色调纸张）、森林、午夜（OLED纯黑）、高对比度以及磷光绿/磷光琥珀（带有细微扫描线的复古终端风格）；此外还有模式（浅色/深色/跟随系统；像午夜这样的单模式主题会固定模式，此时标题栏中的浅色/深色切换按钮会暂时失效）、语言、每周开始于、密度和界面缩放，还有字体卡片，其中三个栏位——界面、内容和代码——以及内容字号；每个栏位都提供主题默认、衬线、无衬线、等宽或自定义…（代码栏位仅限等宽），选择自定义后会出现一份列表，其中每种字体都以自身的样子预览，并说明本机是否装有它；未安装的字体无法选择，下方仍保留一个自由输入框。字体按设备单独保存。编辑器与笔记：默认视图。启动与行为：自动打开上次的仓库、兼容性警告提示。更新：Plainva会在启动时静默检查新版本，发现更新时显示提示——点击它即可立即下载并安装更新（该提示会一直显示，直到Plainva重启）。可通过启动时检查更新关闭。关于与诊断：版本信息、系统钥匙串状态、性能指标、导出诊断信息…（不含笔记内容）和报告问题。快捷键始终可以通过F1或左下角的显示快捷键查看。
• 仓库——所选仓库在侧栏中显示为一张小卡片（当前仓库带有圆点）；有多个仓库时，卡片下方的切换会打开一个选择列表。下方是每个仓库的区域：云账户是所有云端登录的唯一入口——连接账户…用于选择服务商（Microsoft、Google、Nextcloud、Dropbox、S3、WebDAV或某个邮箱）以及该账户应承担的服务（文件、日历与任务、邮件）。服务区域同步（参见设置同步）、日历（参见日历与任务）和邮件（参见邮件捕获）只有在已连接的账户承担对应服务时才会出现。始终存在的区域：内容与结构（每日笔记、模板与任务包括模板文件夹以及文件夹 → 模板和笔记类型 → 模板的规则（这些规则在手机上同样适用）、收件箱文件夹、附件文件夹、OKF（Open Knowledge Format）——参见OKF——以及扩展数据库）、备份与版本历史和维护（重建索引、恢复已删除的文件、仓库统计）。

标签页

• 右键点击标签页可打开其菜单：固定标签页、重新加载、分屏打开（右侧）、复制路径、在文件管理器中显示，以及关闭分组。
• 固定标签页会把标签页固定在原地：它会移动到标签栏的最前端，用图钉图标取代关闭按钮，并且不管执行关闭其他标签页 / 关闭左侧标签页 / 关闭右侧标签页 / 关闭所有标签页中的哪一个，都不会被关闭。要关闭它，需先取消固定标签页。
• 重新加载会放弃当前视图，重新从磁盘读取文件——当其他程序修改了该文件时很有用。如果标签页中有未保存的更改，Plainva会拒绝重新加载，以免覆盖你的工作。

多个窗口

Plainva不必只停留在一个窗口里。你现在需要的任何东西，都可以在你的工作旁边打开：

• 右键点击一个标签页 → 在新窗口中打开。 该标签页会离开当前窗口，转移到新窗口中继续存在；不会留下副本。
• 在操作栏中右键点击 关系图、任务、日历或邮件，同样可以选择这一项。之后再次点击该项，Plainva会把那个窗口带到最前面，而不是第二次打开该视图。
• 命令面板 → 打开通讯窗口会启动一个已经分好屏的窗口：左边是邮件，右边是日历。
• 命令面板 → 打开第二个窗口会再次打开整个外壳——侧边栏、操作栏、标签页、状态栏。这是给第二台显示器准备的选项。
• 在撰写一封邮件时，独立窗口图标会把撰写窗口提升为独立窗口——连同你已经输入的所有内容。

独立窗口是一个完整的Plainva：它带有标签页，可以分屏，并通过与主窗口相同的链路保存。它刻意不带有的是侧边栏和操作栏——它就是为了只显示一件事。

第二个窗口则带有这两者——并且带有它自己的仓库。它打开时会显示主窗口所在的仓库；点击左下角的仓库切换器可以单独把它切换到另一个仓库，而不会牵动主窗口一起切换。设置、导入向导和新建仓库都留在主窗口——按钮就在那里，点击其中一个会把主窗口带到最前面，并在那里打开对应界面。与你的工作相关的一切在两者中都是一样的：编辑、保存、搜索，以及状态栏中的同步状态。侧边栏的宽度和你折叠的内容，则分别属于各自的窗口。

一段内容永远只会在一个窗口中打开。 打开一篇已经在别处显示的笔记，那个窗口就会被带到最前面。这是刻意如此：同一个文件打开两个编辑器，是丢失工作内容最可靠的方式。撰写邮件是例外——同时写两封邮件是很常见的事。

窗口标题中的图钉会让一个窗口始终置顶，方便你在另一个窗口中工作。

下次启动时，每个曾经拥有窗口的仓库都会恢复，其附加窗口也会恢复到原来的位置。如果你不希望如此：设置 → 启动与行为 → 窗口。未发送的邮件永远不会被恢复——撰写窗口中的内容只存在于内存里，一个声称保留了它的窗口，只会比没有窗口更糟。

同时打开多个仓库

两个仓库并排使用——工作与私人、项目与归档——都需要两个窗口：一个窗口只显示一个仓库。打开第二个窗口（命令面板 → 打开第二个窗口），然后在左下角切换它的仓库。此后两者各自独立运行：各自的搜索、各自的同步、各自的提醒。

• 每个仓库各自同步。 状态栏中的状态，始终属于你当前所在窗口的那个仓库。
• 两个仓库使用同一个账户没有问题。 Plainva只会续期一次登录，并把它交给另一个仓库使用，而不会让两者互相使对方的登录失效。
• 仓库嵌套会被拒绝。 如果该文件夹位于一个已经打开的仓库内部——或者情况相反——Plainva会说明这一点以及原因：两者会同时监视并同步相同的文件。
• 同一个仓库在两个窗口中打开是允许的；这些窗口共享同一个仓库，一篇笔记依然只会在其中一个窗口中打开。
• 最后一个窗口离开，仓库就会关闭。 一旦没有任何窗口还在关注某个仓库，Plainva就会把它收起来——但会先完成正在进行的写入。

栏与区域

最左侧的操作栏、左侧栏的标签、文件树上方的分区，以及右侧栏的分区，工作方式都相同。

操作栏提供新建笔记、新建文件夹和新建数据库（.base）。这三项都会在文件树中选中的文件夹内创建；如果选中的是文件，则创建在该文件所在的文件夹中；如果什么都没有选中，则创建在顶层。日记不遵循这条规则——它总是会归入你在设置中为它指定的文件夹。如果你不需要其中某一项，可以将其隐藏。

就地调整： 按住某个按钮或分区标题片刻后拖动到新位置——单击仍然只会触发它的功能，如果在按住的同时滚动页面，页面会照常滚动（拖动会被取消）。Esc可取消正在进行的拖动。右键点击可在无需按住的情况下执行相同的操作：上移、隐藏和自定义栏…。

集中管理： 在设置 → 仓库 → 栏与区域中，五个栏依次上下排列——其中也包括手机的导航栏，因此你可以在大屏幕上安排它。每个栏都是一个列表，中间有一条分割线：线上的所有项都会显示，线下的所有项都会隐藏。在这里，你可以用拖动手柄移动条目——这个页面本身就是在排列一个列表，而这正是手柄的用途。拖到顶部或底部边缘时，页面也会随之滚动，这样一个条目就能在一次移动中从最底部一直到达最顶部。

有两样东西是故意无法隐藏的：操作栏底部的帮助和设置，以及左侧栏的文件标签。其余的一切都可以由你隐藏；被隐藏的操作栏功能仍可通过命令面板（Ctrl+P）访问。当打开的笔记没有内容可显示时，右侧栏的分区根本不会出现。

排列方式属于该仓库，并会通过设置同步传递到你的其他设备。尚未调整过的仓库会沿用你的默认设置——用设为默认来设置它，恢复默认则会把已调整过的仓库还原为它。

自定义界面

• 切换侧边栏：通过标题栏中的两个按钮，或使用Ctrl+Alt+B（左）/Ctrl+Alt+R（右）——非常适合专注写作。Plainva会记住该状态。
• 命令面板：Ctrl+P打开命令——输入内容并按回车执行（新建笔记、日记、分屏、侧边栏、立即备份等等）。
• 密度：在设置 → 应用 → 外观中，可以在舒适和紧凑之间选择——紧凑会压缩列表、菜单和表格行；笔记内容不受影响。
• 自定义主题：设置 → 应用 → 外观 中的 我的主题 卡片用于选择主题，卡片上的铅笔会打开它的设置页面：基调（浅色/深色）、限定亮度范围内的背景、任意强调色、圆角（字体在同一页面的 字体 卡片中选择）。文字颜色由 Plainva 自动推导，因此永远不会淹没在背景中；过淡的强调色会被修正到至少 3:1，编辑器会说明这一点。在手机上，相同的控件位于 外观 屏幕。
• 字体：在设置 → 应用 → 外观中，字体卡片设置界面、内容和代码的字体（主题默认、衬线、无衬线、等宽，或任意已安装字体的名称）以及内容字号（12–24 px）——字号只会缩放编辑器和阅读视图，界面本身保持不变。
• 字体列表：在 自定义… 下会列出系统字体，每一行以其自身字体显示；未安装的字体会注明且无法选择。下方的名称框可填写任何其他已安装的字体。
• 界面缩放：把整个界面缩放到80%至150%之间——在设置 → 应用 → 外观中设置，或使用Ctrl+Plus/Ctrl+Minus调整（Ctrl+0重置）。
• 无原生弹窗的对话框和提示：确认操作会显示为按你的主题样式渲染的Plainva对话框（破坏性操作带有红色按钮），简短提示则以右下角的轻量吐司通知呈现——不再有系统弹窗。

关系图

通过Ctrl/Cmd+Shift+G（或右侧边栏中的关系图分区），你可以把你的仓库看作一张地图：文件夹是气泡，笔记是节点，关联是带标签的边——还包括清理模式和时间回放。详见关系图。

记住右侧边栏设置

对于当前打开的笔记没有内容可显示的分区——大纲、反向链接、属性、数据库——根本不会出现，而不是以灰色显示占位。整个右侧边栏会为笔记记住一个全局偏好；没有笔记上下文的整屏视图只会暂时关闭它。

当你把面板拖窄时，它会分三个阶段变化，以免出现问题：

• 280 px 及以上——与平常一样。
• 232–280 px——属性会把名称放在值的上方而不是旁边，过长的值会换行，各分区变得更紧凑。
• 低于 232 px——日历会显示一周而不是一个月（七天，周数显示在右下方）；此时的月历网格每个单元格只有14像素，已经不再是日历了。关系图会变短，反向链接只显示文件名，不再显示路径那一行。

右侧边栏不能小于200 px——低于这个宽度，任何分区都无法使用。左侧边栏仍然可以缩小到150 px，因为文件名只需要截断显示即可。

另请参阅

• 笔记与Markdown——关于写作的一切
• 快捷键
• 常见问题与故障排查