快速上手

更新日期：2026-07-28

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

什么是仓库？

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

打开或新建仓库

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

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

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

• 打开仓库——Plainva会先问”你的仓库在哪里？“：本地文件夹用于打开这台电脑上一个已有的Markdown文件夹（Obsidian仓库可以直接使用）；在线仓库会把云端已有的仓库同步到一个本地文件夹——每个服务商都遵循相同的三个步骤（连接、选择云端文件夹、选择或创建本地文件夹；参见设置同步）。
• 新建仓库——首先会问”你的仓库要放在哪里？“（在这台电脑上或在在线服务中），然后选择起始结构：从空白开始，或使用预设的文件夹结构；两者随时都可以调整。空仓库只包含一个index.md概览。可用的模板有：PARA、Zettelkasten、ACE (Linking Your Thinking)、Johnny.Decimal、GTD和Journal——每一种都会创建文件夹、一篇带快速指南的欢迎笔记，以及以OKF格式自动维护的index.md概览（文件夹和文件名称跟随应用语言）。Journal模板还会额外配置好仓库的日记设置。PARA、GTD、Zettelkasten和Journal模板还会附带已经关联好的数据库以及配套的笔记模板——例如带有状态看板和领域关联的项目，或指向所属项目的任务。在线路径下，连接会紧接着结构进行：选择服务商、连接、选择云端文件夹或通过新建文件夹新建一个，再选择本地文件夹——所选结构会被创建在本地文件夹中，并在首次同步时上传到云端。

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

界面介绍

• 左侧边栏——三个视图：文件（文件树）、标签（仓库中所有的#标签）和数据库（仓库中所有的.base，按文件夹分组——点击即可打开）；书签和最近打开是文件树上方的两个区域。最顶部是搜索框，旁边带一个**+，用于新建笔记、新建文件夹、新建数据库和日记。搜索框的占位提示文字会说明当前搜索的是什么，只要面板足够宽，标签页就会显示各自的名称——随着面板变窄，先是只有当前激活的标签页保留名称，最后就只剩下图标。底部是仓库切换器、打开日记和设置**。三个视图旁边的双箭头按钮可一键折叠或展开所有文件夹；编辑器 ⋮ 菜单中的 在文件树中显示 会直接在文件树中定位当前笔记。在文件视图中，顶部会显示当前仓库的名称和图标，文件树上方的最近打开栏可以一键访问你最近打开过的笔记。
• 标题栏——你打开的标签页。标签页可以通过拖动重新排序，也可以在编辑器窗格之间移动。
• 编辑器区域——你在这里阅读和写作。通过标签页菜单（向右分屏 / 向下分屏）或快捷键Ctrl+Alt+V / Ctrl+Alt+S，可以把编辑器分成两个窗格，例如让一篇笔记和一个数据库并排显示。
• 右侧边栏——四个分区，可拖动调整顺序：日历（日记）、大纲（当前笔记的标题）、反向链接（谁链接到这里）和属性（笔记的Frontmatter）。
• 状态栏——字数/字符数统计、同步状态（本地/在线/离线）和保存状态（保存中… / 已保存）。

三种编辑器模式

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

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

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

文件树基础

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

日记

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

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

设置

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

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

标签页

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

栏与区域

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

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

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

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

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

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

自定义界面

• 切换侧边栏：通过标题栏中的两个按钮，或使用Ctrl+Alt+B（左）/Ctrl+Alt+R（右）——非常适合专注写作。Plainva会记住该状态。
• 命令面板：Ctrl+P打开命令——输入内容并按回车执行（新建笔记、日记、分屏、侧边栏、立即备份等等）。
• 密度：在设置 → 应用 → 外观中，可以在舒适和紧凑之间选择——紧凑会压缩列表、菜单和表格行；笔记内容不受影响。
• 内容字体：在设置 → 应用 → 编辑器与笔记中设置内容字号（12–24 px）和内容字体（主题默认、衬线、无衬线、等宽，或通过**自定义…**填入已安装字体的名称）——这只会缩放编辑器和阅读视图，界面本身保持不变。
• 界面缩放：把整个界面缩放到80%至150%之间——在设置 → 应用 → 外观中设置，或使用Ctrl+Plus/Ctrl+Minus调整（Ctrl+0重置）。
• 无原生弹窗的对话框和提示：确认操作会显示为按你的主题样式渲染的Plainva对话框（破坏性操作带有红色按钮），简短提示则以右下角的轻量吐司通知呈现——不再有系统弹窗。

关系图

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

另请参阅

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

记住右侧边栏设置

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

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

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

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