Obsidian的过渡指南 — 从Notion/Evernote/Apple Notes开始

首先准备空的练习用Vault，用少量的笔记本看输出。 Obsidian的导入和Vault的制作在下载和安装的家长指南中处理。

1. 在Settings → Community plugins中激活Importer。 这个例子的实际画面是Importer v3.1.9。
2. 用Ctrl+P打开Command palette，选择Importer: Import notes。
3. 选择转移源的格式，确认输入文件和Output folder。 也读执行前的Preview。
4. Start import，分别确认显示完成的笔记、附加、failed的件数和Vault中保存的文件。

这次的初期准备，将官方发布的main.js・manifest.json・styles.css手动配置到隔离Vault，激活后用实际GUI进行操作。 不是点击Community plugins的Browse → Install导入的验证。 选定的3.1.9以外的版本也会有相同的结果，这是未验证的。

Obsidian和Installer的实际版本画面

这个版本的Notion有两条路线。 这次选择了File import。 画面说明“不需要代币和网络连接”“不保留数据库”。 Notion account的数据库、数式的转移是另外的途径，这个验证没有执行。

1. Notion选择后，选择File import。 实际画面介绍了HTML格式的export。 在自己的过渡中，按照官方的export程序准备文件。
2. Choose file中选择ZIP。 验证时，在OS的文件选择画面中选择了官方fixture的notion-testspace.zip。 外部ZIP中还有另一个ZIP1件的构成，也直接读取了。
3. Folders to import确认后Continue。 这次以选择所有对象的初始状态进行。
4. Output folder是Notion，Attachment location是Vault folder，Save parent pages in subfolders是ON。 这是没有现有笔记本的空Vault的例子。 没有验证Update的覆盖、竞争处理。
5. 在下一个画面中打开Save Notion ID，关闭Single line breaks，在未选择模板的初始状态下阅读Preview，选择Start import1次。

父页面是Notion/Notion-Testspace/Notion-Testspace.md，子页面进入了同一个下属。 Attachment Tests还在同名文件夹中。 父正文的3的链接，唯一对应这个Vault对应的子笔记本。

---
notion-id: 1590080aa5a3802488c2e857dea7aa7d
---
**Notion-Testspace** is a Notion workspace created by [@felciabatta](https://github.com/felciabatta) to test the [Obsidian Importer](https://github.com/obsidianmd/obsidian-importer) plugin.

This workspace has been exported to HTML format, [as described here](https://help.obsidian.md/import/notion), and comprises a single parent-page (this one) and the following sub-pages:

[[Block Reference]]

[[Formatting Tests]]

When importing to Obsidian, if you leave _**Output folder**_ blank all the pages will be stored in a single parent-folder called _**Notion-Testspace**_.

---

[[Attachment Tests]]

5张的JPEG与原ZIP的图像bytes・SHA256一致。 文件名URL编码被解码，кошки-самые-лучшие.jpg也被保存。 在原export中已经变成----.jpg的名字，还是那个名字。

---
notion-id: 15f0080aa5a380c6b16cfed449a03a8b
---
# Filenames

The files below are included to test filenames with special characters — sometimes Notion url-encodes these, sometimes the filenames are entirely destroyed.

![[felis-catus.jpg]]

![[кошки-самые-лучшие.jpg]]

![[----.jpg]]

![[kocky-jsou-nejlepsi.jpg]]

![[name-with-percents-006300610074.jpg]]

1. Importer再次从Command palette打开，选择Evernote (.enex)。 实际画面介绍了每个笔记本的ENEX export。
2. Choose files中选择ENEX。 在这个例子中，在OS的文件选择画面中传递了官方fixture的code-block-indentation.enex。
3. Output folder是Evernote，Attachment location是Vault folder，模板未选择。 从Continue开始阅读Preview，选择了1次Start import。
4. 完成显示是3 imported / 0 attachments / 0 failed。 保存的Evernote/code-block-indentation/有3笔记本。

空白的例子保留了4・8的缩进和空行。 NBSP的例子变成了普通的空白，但4、8个缩进是一致的。 包含反斜杠、*、_的字符串也作为代码块内的文字保留下来。

```python
def f(x):
    if x:

        return 1
    return 0    # aligned
```

```bash
grep -o 'a\\*b' file \\
  | sed 's/_x_/*y*/'
```

这个3例子中没有生成的frontmatter。 制作、更新日期和标签等所有metadata、Evernote的附加、任意格式的保留尚未验证。

官方的固定source正在检查Platform.isMacOS和桌面环境。 这次运行的是Linux版Obsidian，所以没有尝试Apple Notes的实际导入。 从source中读取对应条件和在Mac上实际转移是不同的。

从Apple Notes转移时，请确认官方的Apple Notes的转移步骤和对象环境。 这个页面的Notion/Evernote的成功件数，不能作为Apple Notes的实机成功使用。

再现用的输入2件是官方存储库同一固定commit中的测试fixture。 不是自己账户的export。 可以用练习用Vault尝试相同的输入，也可以用于比较下面的保存正文。

保存例子是实际用GUI生成的Markdown的原bytes。 ZIP中只包含正文7件。 不包括图像、plugin本体、设置、输入fixture。 如果想将附加笔记的链接用图片显示的话，从Importer导入原输入到自己的练习用Vault进行确认。

• Linux版Obsidian/Installer 1.13.7、Importer v3.1.9的实际画面。 通过手动配置官方release assets3件的隔离Vault从GUI激活了。
• Notion File import和Evernote ENEX各1次，从实际的OS文件选择和Start import开始执行。 将保存的7笔记、5本地图像、有限的正文、链接、layout例子与原fixture进行了核对。
• Notion的附加笔记和Evernote的空白代码笔记，从同一启动内的文件列表再次打开，确认bytes一致。 重启应用程序后重新打开是未验证的。
• PNG・输入fixture・保存Markdown保持原bytes。 辅助代码用于准备和读取，导入和输出文件生成没有用plugin API代替。

保留了准备的profile ID错误、点击对象的selector等待失败、文件选择中仅靠第一个Return没有关闭的事实。 实际选择确定是通过OS画面的Open按钮进行的。 应用程序是GUI Close后的实际wait在exit 0，Xorg是所有process的SIGTERM和实际wait 0。 控制器在末尾的Xlib结束处理中退出了1，整体没有正常结束。 详细情况总结在验证记录中。

真实账户的export、Notion account/API・数据库・数式、Apple Notes的执行、全部metadata/全部layout/任意的大规模数据、其他OS、iOS、Sync、SimpleMemo、速度・安全性・生产力的效果尚未验证。

• 导入器3.1.9官方发布
• 固定commit的官方README
• Notion官方fixture的原件
• Evernote官方fixture的原件
• Apple Notes的固定source・OS条件

虽然进行了选定版的source和官方分发物的核对，但并不是从source再现同一构建的验证。

转移后确认笔记的数量、附件、链接、易读性，修改必要的正文。 第一次使用Vault和笔记本间链接的人，可以在父指南中确认Obsidian的基本操作。