Skip to content

快速开始 ​

看到这个页面,相信你对 Yank Note 还是有一些兴趣。接下来,就让我们跟随下面的步骤,开始上手 Yank Note。

在线体验 ​

在下载 Yank Note 之前,你可以先访问 Demo 网站体验一下 Yank Note 的各种功能。

但是需要注意,Yank Note 是一款桌面版应用,本身不直接支持 Web 部署。Demo 模式只是一个快速体验的网站,很多功能不能使用,也不能真正的保存文件。因此,你仍然需要参考后面的步骤,下载并安装应用,才能真正使用 Yank Note 的各种功能。

下载安装 ​

官网下载(推荐) ​

你可以访问 官网下载地址,然后根据自己电脑的操作系统,选择下载的安装包。通过官网下载在中国大陆速度会更快。

Github 下载 ​

你还可以在 Yank Note 的 Github Release 页面找到更多下载资源,包括正在开发中的测试版本。

Mac App Store(不推荐) ​

Yank Note 还提供 macOS App Store 版本。

因为苹果的沙盒机制的缘故,此版本部分功能不能使用:

  1. 没有内置终端
  2. 不能使用“在浏览器中打开”功能
  3. 不能使用“分享”功能
  4. 代码运行功能受限
  5. 一些扩展不能使用,如 “Git 提交” 扩展
  6. 沙盒可能会产生一些问题 [BUG]: macOS 运行 Python 代码产生 spawn EPERM 错误 app store下载安装后启动闪退

总之,如果你非常注重内容安全,可以使用 Mac App Store 的版本,否则建议还是使用安装版以获得更好的使用体验。

NOTE

因没有 App 备案号,Yank Note 将不在中国大陆 Mac App Store 上提供

WARNING

Mac App Store 中的高级版激活机制和安装版不同,因此高级版的定价会有差异,也不支持转移激活码

移动端 ​

目前 Yank Note 的移动端仍在规划中,暂时没有更多进展。

Yank Note 一些功能扩展了 Markdown 语法,但都尽可能使用现有 Markdown 语法或参考其他比较流行的 Mardown 解析器(如 pandoc、vitepress)的做法。因此你可以寻找一些其他的移动端 Markdown 编辑器,基本也可以工作得很好。

上手使用 ​

应用安装完毕并启动后,你可以看到如下界面。后续的文档中,我们也将使用下图的术语来描述界面和操作。

Img

添加仓库 ​

Yank Note 的文件管理是基于仓库(一个目录),因此如果想要管理本地的 Markdown 文件,你需要先添加一个仓库。

  1. 点击“添加仓库”按钮
  2. 在设置中选择一个你想要储存 Markdown 笔记的位置
  3. 点击“保存”按钮

Img

这样,你就可以在 Yank Note 中管理和编辑 Markdown 文件了。

创建文件 ​

  1. 点击 Yank Note 文件侧栏目录条目上的“添加文件”按钮
  2. 输入想要创建文件的文件名
  3. 点击“确认”按钮

Img

这样,你就成功的创建了一个新的 Markdown 文件。

编辑文件 ​

Yank Note 的编辑器使用的是 Monaco Editor,使用体验和 VSCode 基本一致。

为了更好的进行 Markdown 编辑,Yank Note 做了很多针对 Markdown 编辑场景的优化,如建议补全、符号包裹、有序列表自动编号等各种功能。在后面的文档中会一一描述。

现在,你可以简单的在编辑器中键入/ 符号,来体验编辑器的各种功能。

Img

默认设置下,Yank Note 会对当前编辑的文件做自动保存。如果你看到标签栏中当前文件名前面有 * 符号,这表示文件还未保存。等待几秒中后,文件保存完毕,* 号消失,则代表文件已安全保存到磁盘。

当然,你也可以在设置中更改文件自动保存的行为。

文件管理 ​

使用“文件侧栏”,你可以轻松的管理当前仓库的文件

  1. 添加或创建文件/目录
  2. 移动文件(支持拖动)
  3. 标记文件
  4. 重命名文件
  5. 重复文件
  6. 在系统中打开
  7. 复制文件名/路径

上述功能(视情况可能不同)都可以通过使用点击鼠标右键唤起上下文菜单得到。

Img

下一步 ​

通过上面的步骤,相信你已经能在 Yank Note 中管理和编辑 Markdown 文件了。接下来,可以继续了解 Yank Note 的其他内容