就地编辑 Markdown 文件
有些 Markdown 并不在你的笔记里:Git 仓库中的 README、iCloud 云盘里的某个文件、同事发给你的笔记。Varlig 可以就地编辑这些文件,不必把它们拷贝到你的资料库中。
打开文件
选择 文件 › 打开 Markdown 文件…(⌥⌘O),或者在访达中通过打开方式 ▸ Varlig 打开该文件,也可以在终端里运行 open -a Varlig notes.md。Varlig 可以打开 .md、.markdown、.txt 等纯文本文件,最大 32 MB。
文件窗口看上去和你熟悉的编辑器一样,标题栏中带有 文件 标记、文件名、所在文件夹及其存储状态。点按文件夹按钮,可以在访达中显示它。
打开文件夹
选择 文件 › 打开文件夹…(⌃⌘O),把文件夹拖到 Dock 中的 Varlig 图标上,或者在终端里运行 open -a Varlig ~/Projects/handbook。文件夹窗口会在边栏中按子文件夹列出该文件夹里的 Markdown 和文本文件,并在与文件窗口相同的编辑器中编辑你选中的那一个。如果有 README,就先打开它;之后会回到你上次阅读的文件。
列表会随文件夹的变化而更新:其他 App 或 git checkout 添加、删除或重命名的文件会自动出现或消失。.git 这样的隐藏文件夹和 node_modules 不会列出。过滤文件 可以按名称或路径筛选列表,+ 会在你正在阅读的文件旁边新建一个空的 Untitled.md。选择另一个文件时,离开的那个文件会被保存;指向同一文件夹中文件的相对链接会在同一个窗口里打开。
除了你自己的文件,Varlig 不会往文件夹里写入任何东西——没有数据库,也没有隐藏的设置——所以它和原来一样便于携带。
存储
你停止输入大约一秒后,编辑内容会自动存储,文件 › 存储(⌘S)则会立即存储。标题栏中会显示 已存储、已编辑,或者显示 Save failed 并附上原因。
Varlig 会按照文件原本的样子写回:相同的换行符、相同的字节顺序标记,而且只有原本有末尾换行时才保留末尾换行。写入是原子的,并保留文件的权限,所以由 Git 跟踪的文件会呈现干净、精简的差异。
文件 › 存储为… 会在别处写入一份副本,并继续编辑那份副本。
文件旁边的图片和链接
相对引用以文件自身所在的文件夹为起点,所以  和 [the plan](plan.md) 会打开你预期的内容,最多可以向上追溯三层文件夹。你粘贴或拖入的图片,会存储在文件旁边一个以它命名的文件夹中,比如 notes.assets/。
在文件窗口中,标签和 [[笔记链接]] 只是普通文本:它们属于你的资料库,而磁盘上的文件没有地方保存它们。
当文件在磁盘上发生变化
如果在你有未存储的编辑内容时,别的东西改动了这个文件 —— 一次 git pull、一个同步客户端、另一个编辑器 —— Varlig 会保留两个版本,并明确告诉你:
- 比较… 会把两者并排显示,标出哪些内容只在磁盘上,哪些内容只在你的窗口里。
- 保留我的版本 会存储你的版本,并把磁盘上的版本作为一份带日期的副本保留在文件旁边。
- 使用磁盘版本 会显示磁盘上的版本,并把你的版本作为一份带日期的副本保留在文件旁边。
两种方式都不会覆盖任何内容,副本的命名也让你一眼就能分辨,比如 notes (disk version 2026-09-22 1415).md。
如果文件在你编辑期间被删除或移动,Varlig 会告诉你,并提供 存储为…,所以你写的内容绝不会无处安放。
答案格式随文件保存
一行的答案格式 —— 小数位数、分隔符、记数法 —— 以及它的 小计 或 时间点 设置,都保存在文件的元数据(一种扩展属性)中,而不会写进 Markdown。文字完全保持你写的样子;下次打开这个文件时,无论是在文件窗口还是文件夹窗口中,每一行都和你离开时一样。你编辑、插入或移动的行会保留各自的设置;文字已经不在的行会失去它的设置,而不会把设置转给另一行。
有些工具不保留扩展属性:Git、大多数压缩工具、一些同步服务,以及为 Windows 格式化的磁盘。这时格式会恢复为你的默认设置,文字不受影响。如果完全不想让 Varlig 写入文件的元数据,请在 设置 › 编辑器 中关闭 在 Markdown 文件中记住答案格式。该选项默认打开。
文件窗口有哪些不同
- 没有版本历史,没有笔记密码,也没有备份:磁盘上的这个文件就是唯一的副本。
- 计算块照常可用。你为某一行选择的答案格式或行设置会随文件保存(见上文),而不会写进它的文字。
varlig://链接会跳转到某篇笔记;它们绝不会从文件中运行自动化操作。