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的基本操作。