笔记与Markdown
更新日期：2026-08-14
Plainva中的每一篇笔记都是一个普通的Markdown文件（.md）。本页说明如何舒适地写作，以及文件里实际保存了什么——这正是让你的笔记具有可移植性的原因：任何文本编辑器、Obsidian，甚至git diff都能读懂它们。
核心原则：一切皆文本
无论你在Plainva中看到的是什么——格式化文本、表格、属性、图标——它们都以开放的文本形式存储：
---
type: Note
okf_version: "0.1"
tags: [project]
plainva:
icon: "🚀"
header_color: "#2f6f6f"
---
# My Project
A **bold** thought with a link to [[Another Note]].
- [ ] First task---之间的部分是Frontmatter（YAML）：笔记的属性就保存在这里。下面是普通的Markdown正文。Plainva特有的呈现方式（图标、页眉颜色）统一归在plainva:这一个键下——其他程序会直接忽略它。
在实时预览中写作
实时预览是默认模式：Markdown会随输入即时渲染，同时始终保持可编辑。
斜杠菜单
在行首输入/即可打开插入菜单，它按分区分组：
- 基础块——文本、一级标题至六级标题、无序列表、有序列表、待办清单、引用、代码块、表格、分割线、公式 (LaTeX)、Mermaid 图表
- 格式——粗体、斜体、删除线、行内代码、高亮、表情符号
- 链接与媒体——链接、内部链接、图片（网络）、内部图片、嵌入、嵌入数据库、创建内联数据库
- 文档——文档图标、页眉颜色、插入模板
- 标注——13种变体（笔记、信息、待办、摘要、提示、成功、问题、警告、失败、危险、Bug、示例、引用）
更多写作辅助功能
- 选中工具栏——选中一段文字后，会出现一个小工具栏，提供粗体、斜体、删除线、行内代码、高亮和链接。
@提及——在文中任意位置输入@，即可插入日期（今天、明天、昨天，或选择日期…，以ISO日期格式存储）、指向某条笔记的链接，或嵌入一个数据库。- 表情符号——表情符号斜杠命令（
/emoji）会在光标处打开表情符号选择器；也可以输入:name（例如:rocket）获得内联建议。无论哪种方式，Plainva插入的都是真正的表情符号字符（可移植的Unicode），而不是:shortcode:——这样笔记在Obsidian、GitHub等任何地方都能保持可读。（这与保存在Frontmatter中的笔记文档图标是两回事。） - 块柄——鼠标悬停在每个段落时，左侧会出现一个块柄：拖动它可以移动该块，点击它可以打开块操作（转换为文本/标题/列表/待办/引用/代码块、创建副本、上移/下移、删除块）。如果你把一个列表拖到另一个同类型列表旁边，Plainva会插入一条不可见的分隔行
<!-- -->，让两个列表保持独立——在Markdown中，即使有空行，同样式的列表也会合并（在Obsidian中同样如此）。 - 表格——以带点击编辑单元格的组件形式渲染。单元格显示会渲染格式（粗体、斜体、
代码、高亮）、可点击的链接（[[内部链接]]、网址）以及作为换行符的<br>；在编辑时你看到的是原始文本。表格菜单提供插入/删除行和列，以及对齐方式（左对齐/居中对齐/右对齐）。 - 列表可自动延续（按Enter键会插入下一个列表标记），代码块具有语言感知的语法高亮（在阅读模式下同样如此），粘贴的内容会被转换为Markdown（智能粘贴），标题可以折叠。
- 当前笔记内的查找和替换：
Ctrl+F（参见搜索）。
链接与反向链接
- 内部链接：
[[笔记名称]]（内部链接）——可通过斜杠菜单或@加内置笔记搜索插入。经典的Markdown链接[文本](path.md)同样有效。 - 尚不存在的目标：指向一篇尚未创建的笔记的内部链接会以带虚线下划线的浅灰色文字显示（在实时预览和阅读模式下皆是如此）。点击它即可创建该笔记并打开——新笔记会放在当前笔记所在的文件夹中（如果链接本身带有路径，例如
[[文件夹/新笔记]]，则会创建在指定路径下）。如果想先被询问一次，请启用设置 → 应用 → 编辑器与笔记 → 创建空链接前先询问。 - 反向链接：右侧边栏的反向链接分区显示哪些笔记链接到当前笔记——按来源文件分组，多次出现时会显示计数。
- 重命名时保护链接：当你在文件树中重命名一个文件时，Plainva会更新整个仓库中指向它的每一个链接（像
#章节这样的锚点会被保留），并报告：“已更新M个文件中的N个链接为新名称。“
属性（Frontmatter）
右侧边栏的属性分区把笔记的Frontmatter显示为一个表单。添加属性可以新建属性；每个属性都有一个字段类型：
| 分组 | 类型 |
|---|---|
| 基础 | 文本、数字、复选框、日期、日期和时间 |
| 选择 | 单选、状态、多选 |
| 列表与关联 | 列表、标签、关联 |
| 网络与联系方式 | URL、邮箱、电话 |
选择类型可以携带固定选项，每个选项有一个颜色，状态类型还可以设置分组/阶段——这些选项列表在数据库（.base）中管理，参见数据库（.base）。
有两个字段受到保护：type和okf_version是由Plainva管理的OKF系统字段——type的值可以从已知类型的下拉列表中选择，而名称/字段类型/删除都被锁定（背景说明见OKF）。
文档图标与页眉颜色
每篇笔记都可以携带一个图标（Notion风格，位于标题上方，标签页和文件树中也可见）和一条全宽的颜色条：
- 在实时预览中，把鼠标悬停在标题上方即可看到：添加图标 / 添加页眉颜色（之后会变为：更改图标 / 更改页眉颜色）——也可以使用斜杠命令文档图标和页眉颜色。
- 图标选择器有两种模式——表情符号和图标——操作方式完全一致：同一个顶部区域、同一个搜索框，两种模式都有分类（标签页）和一个最近使用区，重启后依然保留。
- 图标集包含约 400 个精选图标，分为十个分类（知识与文件、工作与任务、技术、人与联系、创作与媒体、日常与家、自然与天气、旅行与地点、金钱与数字、符号与状态）。搜索会匹配名称和关键词。
- 在图标模式下，你先在上方选一个颜色——与标题色条相同的调色板，A 表示默认颜色，自定义颜色… 可填任意值。它会应用到你随后点选的那个图标上。
- 两者都保存在Frontmatter的
plainva:键下（icon、icon_color、header_color）——纯粹的呈现信息，不会影响其他程序。
模板
在设置 → 仓库 → 内容与结构（点击输入框旁的 选择文件夹… 可直接在仓库中选择文件夹）中设置模板文件夹。之后可以通过Ctrl+Alt+T或斜杠命令插入模板来插入模板。模板完全定义新文件的内容——包括Frontmatter：如果模板自带type，模板的值优先生效。插入到现有笔记时，模板的 frontmatter 会被省略——只插入内容。
占位符：模板会填充具名的占位符——没有脚本，没有表达式；这一切都不会执行代码。
| 占位符 | 插入内容 |
|---|---|
{{title}} | 笔记的标题 |
{{date}}, {{time}} | 日期和时间；使用自定义格式：{{date:DD.MM.YYYY}} |
{{date+7}}, {{date-1}} | 偏移后的日期，可与格式组合使用 |
{{yesterday}}, {{tomorrow}} | 前一天、后一天 |
{{weekday:monday}}, {{weekday:next friday}} | 本周或下周的那个星期几；第二个冒号之后可跟格式：{{weekday:monday:DD.MM.}}。一周从哪天开始取决于你的日历设置 |
{{daily}}, {{daily+1}}, {{daily-1}} | 指向今天、明天或昨天日记的链接 |
{{folder}}, {{vault}} | 笔记所在的文件夹、仓库的名称 |
{{cursor}} | 不插入文本——标记之后光标的落点 |
{{prompt:Label}}, {{prompt:Label|Default}} | 向你询问一段文本（显示为Label） |
{{select:Label|A,B,C}} | 向你提供一份可选择的清单 |
{{date_prompt:Label}} | 向你询问一个日期 |
{{selection}} | 选中的文本——插入模板时使用 |
{{clipboard}} | 剪贴板——它会以预先填好的问题形式出现，绝不会在笔记中不知不觉地出现 |
\{{date}} | 占位符本身，未被解析 |
当模板需要询问时，Plainva 会在写入笔记之前把所有问题集中在一个对话框中提出——无论是插入还是创建；取消操作不会创建任何内容。只有在后台创建的笔记（例如任务同步）才不会被询问：那里的答案会保持为空。Plainva 不认识的占位符会保持原样可见——这样，一个拼写错误看起来就像一个拼写错误。
在手机上同样的引擎在运行：占位符会被替换，模板的问题会一起出现在一个表单里（取消则不会创建任何内容），并且文件夹 → 模板和笔记类型 → 模板的规则同样适用——因此Projekte/中的笔记在两台设备上都会以相同的方式开始。有两点不同：这些规则是在桌面端设定的（手机只是应用它们），并且{{weekday:…}}在那里始终从星期一开始计算，因为移动端还没有一周从哪天开始的设置。
仅属于模板的设置：模板可以带有只对模板自身生效的设置——例如它的任务不出现在任务视图中，或者它属于哪些数据库。由它创建的笔记不会继承这些设置。非常旧的日记可能仍然带着它们；如何找到它们，请参见常见问题与故障排查。
文件夹模板：在设置 → 仓库 → 内容与结构 → 模板中，你可以把一个文件夹关联到一个模板——之后在该文件夹里新建的每一篇笔记都会以这个模板开始，无需你做任何选择。这项关联同样适用于子文件夹；当多个关联都匹配时，路径最长的那个胜出（项目/客户胜过项目）。你也可以用同样的方式把模板关联到笔记类型；只有在没有任何文件夹规则覆盖该笔记时，这项关联才会生效——文件夹胜过类型。从模板新建笔记…（在文件树中右键点击、使用命令面板或快速切换器）可以让你明确选择一个模板——它会胜过任何关联。这些关联保存在设置中，而不是笔记里，并会通过设置同步传递到你的其他设备。
新建模板随处可用：命令面板（Ctrl+P）提供创建新模板（会打开一个全新的模板供编辑）和将当前笔记保存为模板（把当前打开的笔记复制到模板文件夹）。模板就是普通的Markdown文件——可以直接在文件树中编辑、重命名或删除它们。
日记
打开日记（侧边栏）或点击日历中的某一天，会使用你设置的日期格式，在已配置的日记文件夹中创建今天的笔记，也可以选择性地基于模板创建。
任务、公式、图表与脚注
-
任务复选框：
- [ ] 任务在任何地方都会渲染为一个复选框——而且在阅读模式下可以直接点击它：Plainva会把[x]或[ ]写回文件。 -
数学公式（LaTeX）：行内的
$E = mc^2$和作为代码块的$$…$$在阅读模式和实时预览中都会渲染为公式（KaTeX）。当光标停留在公式内部时，会显示其语法；点击一个已渲染的公式即可打开它进行编辑。只有源码模式会始终显示原始语法。你不必死记$$…$$代码块——斜杠命令公式 (LaTeX)（/katex）会插入它，并把光标放在其中。 -
Mermaid图表：语言标记为
mermaid的代码块（最快的方式是使用斜杠命令Mermaid 图表，/mermaid）会在阅读模式和实时预览中被绘制为图表——点击图表即可显示代码进行编辑：```mermaid graph TD Idea --> Note --> Knowledge ``` -
脚注：
文本[^1]加上文末的[^1]：脚注内容。——阅读模式会渲染出引用标记和带跳转标记的脚注列表。最快的方式是使用脚注斜杠命令（/footnote）：它会插入下一个空闲的引用标记，并直接跳转到笔记末尾的定义处。
打印与另存为PDF
编辑器的**⋮菜单和命令面板（Ctrl+P）中都有打印 / 另存为PDF…**：打印始终使用阅读视图（如果当前处于实时预览/源码模式，Plainva会先自动切换过去）。在系统对话框中，你可以选择”另存为PDF”而不是打印机。
导出笔记
- 导出为 Markdown…（编辑器**⋮**菜单或命令面板）：通过系统对话框把笔记的副本保存到任意位置——例如交给另一个程序使用。链接的附件（图片）不会随之导出；如果笔记引用了附件，Plainva会显示一条简短提示。
- PDF：使用上方的打印 / 另存为 PDF…，并在系统对话框中选择”另存为PDF”。
在其他编辑器中打开笔记
你的笔记是普通的.md文件，因此任何Markdown编辑器都能打开它们。编辑器的**⋮菜单中有在默认应用中打开**，会把当前笔记交给你系统默认用于打开Markdown文件的应用程序（Byword、MacDown、VS Code等）。Plainva会持续监视该文件，因此你在那里所做的修改会自动出现在这里。
图片与附件
- 插入：斜杠命令内部图片（在仓库中搜索并嵌入）或图片（网络）（通过URL插入）。也可以直接从剪贴板粘贴一个文件（Ctrl+V）——图片可以，PDF 或表格同样可以。你还可以把文件从文件资源管理器拖拽到编辑器中：图片会被嵌入（
![[…]]），其他文件会被复制进来并链接（[[…]]）。 这些文件存放在哪里是一项设置：设置 → 你的仓库 → 内容与结构 → 附件文件夹（默认Attachments，带文件夹浏览器）。留空则与笔记放在一起，也就是此设置出现之前 Plainva 的做法。该文件夹会随设置同步一起传递，因此电脑和手机会把附件放在同一个位置。 - 附加文件…：斜杠命令附加文件…以及笔记⋮菜单中的同名条目会打开系统的文件对话框；在手机上它位于＋面板中的从设备选择文件…。文件会被复制到附件文件夹——图片会被嵌入（
![[…]]），其他文件则被链接（[[…]]）。 - 链接：输入
[[，Plainva 会先给出笔记，下方的附件中则是仓库里的文件。 - 查看：图片文件（PNG、JPG、GIF、WebP、SVG、BMP、AVIF）会在内置的图片查看器中打开，支持放大/缩小、适应窗口和实际大小（1:1）。
- 编辑：编辑按钮会打开图片编辑器，提供裁剪、旋转/翻转、调整大小、绘图工具（画笔、箭头、矩形、文字）以及撤销/重做。可以直接保存，也可以另存为副本…。可编辑的格式是PNG、JPG和WebP；其他格式仅支持查看。
- 文本文件在 Plainva 内部打开：
.txt、.csv、.json、.yaml、源代码等。如果你的保险库需要更多，请在设置 → 你的保险库 → 内容与结构 → 更多文本文件中填写扩展名——该列表只能增加，永远不会移除任何内容。若文件开头显示它其实不是文本，Plainva 不会显示它，而是提供默认程序：显示并保存会损坏该文件。以这种方式打开的文件在保存时保留其换行符和 BOM——它属于你，而不是 Plainva。编辑时，Plainva 会根据文件扩展名为文本着色——与笔记中代码块获得的语法高亮一样。笔记工具都保持关闭：没有实时预览，没有属性栏，没有[[links]]，没有”/“菜单。查找和替换依然保留，因为这是文本功能，而不是笔记功能。 - 其他附件单击后会在系统的默认程序中打开——在文件树中如此，通过
[[链接]]、书签或搜索打开时同样如此。
那Obsidian呢？
一切仍然是带有标准Frontmatter的标准Markdown。Obsidian可以完整地打开这些文件；它会在属性面板中把打包的plainva:键显示为一个不可编辑的对象——这是刻意如此，且无害。
另请参阅
- 数据库（.base）——把笔记变成表格、看板或日历
- OKF——
type和okf_version意味着什么 - 搜索和快捷键
设置多行选择的格式
当选择范围跨越多行时，粗体、斜体、删除线、高亮和行内代码会分别应用到每个非空行。列表、引用、标题和任务前缀会保留在行内标记之外。链接仍限于单行，因为多行链接标签不是可移植的 Markdown。
ATX 标题和 GFM 任务是两种互斥的块类型，因此 Plainva 不会写入无效的混合形式。两种块都支持行内格式；可使用 - [ ] **重要任务** 来突出任务标题。