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 폴더를 확인합니다. 실행 전 미리보기도 읽습니다.
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 계정의 데이터베이스·수식 이전은 별도의 경로이며, 이 검증에서는 실행되지 않았습니다.

1. Notion을 선택한 후, File import를 선택합니다. 실제 화면은 HTML 형식의 export를 안내했습니다. 자신의 마이그레이션에서는 공식 export 절차에 따라 파일을 준비합니다.
2. Choose file에서 ZIP을 선택합니다. 검증에서는 OS 파일 선택 화면에서 공식 fixture의 notion-testspace.zip을 선택했습니다. 외부 ZIP 안에 다른 ZIP이 1개 있는 구성도 그대로 읽어들일 수 있었습니다.
3. Folders to import를 확인하고 계속하십시오. 이번에는 모든 대상을 선택한 초기 상태 그대로 진행했습니다.
4. Output folder는Notion、Attachment location은Vault folder、Save parent pages in subfolders는ON였습니다. 기존 노트가 없는 빈 Vault의 예시입니다. 업데이트의 덮어쓰기 및 경쟁 처리는 검증하지 않았습니다.
5. 다음 화면에서는 Save Notion ID를 ON하고, Single line breaks를 OFF한 뒤, 템플릿을 선택하지 않은 초기 상태에서 미리보기를 읽고, Start import를 1번 선택했습니다.

상위 페이지는 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 수출을 안내했습니다.
2. Choose files에서 ENEX를 선택합니다. 이 예에서는 공식 fixture의 code-block-indentation.enex를 OS의 파일 선택 화면에서 전달했습니다.
3. Output folder는 Evernote, Attachment location은 Vault folder, 템플릿은 선택되지 않았습니다. Continue에서 Preview를 읽고, Start import를 1번 선택했습니다.
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가 없습니다. 생성·업데이트 일시 및 태그 등 모든 메타데이터, Evernote 첨부, 임의의의 서식 유지는 아직 검증되지 않았습니다.

공식 고정 소스는 Platform.isMacOS과 데스크톱 환경을 확인하고 있습니다. 이번에 실행한 것은 Linux 버전 Obsidian이므로, Apple Notes의 실제 가져오기는 시도하지 않았습니다. 소스에서 대응 조건을 읽을 수 있는 것과 Mac에서 실제로 이전할 수 있었던 것은 별개입니다.

Apple Notes에서 이동하는 경우, 공식 Apple Notes의 이전 절차와 대상 환경을 확인해 주세요. 이 페이지의 Notion/Evernote의 성공 건수를 Apple Notes의 실제 기기 성공으로 사용할 수 없습니다.

재현용 입력 2건은 공식 리포지토리의 동일한 고정 커밋에 있는 테스트 fixture입니다. 제 계정의 내보내기가 아닙니다. 연습용 Vault에서 동일한 입력을 시도하거나, 아래의 저장된 본문을 비교하는 데 사용할 수 있습니다.

저장 예시는 실제로 GUI에서 생성한 Markdown의 원본 바이트입니다. ZIP에는 본문 7만 포함하고 있습니다. 이미지, 플러그인 본체, 설정, 입력fixture는 포함되지 않습니다. 첨부된 노트의 링크를 이미지와 함께 표시하고 싶으시면, 원본 입력을 자신의 연습용 Vault로 Importer에서 가져와 확인합니다.

• Linux 버전 Obsidian/Installer 1.13.7, Importer v3.1.9의 실제 화면. 공식 release assets3건을 수동으로 배치한 격리 Vault로 GUI에서 활성화했습니다.
• Notion 파일 가져오기와 Evernote ENEX를 각각 1회, 실제 OS 파일 선택 및 Start import에서 실행합니다. 저장한 7 노트와 5 로컬 이미지, 유한한 본문·링크·레이아웃 예시를 원본 fixture와 대조했습니다.
• Notion의 첨부 노트와 Evernote의 공백 코드 노트를 동일한 부팅 내 파일 목록에서 다시 열어 bytes 일치를 확인합니다. 앱을 재부팅한 후 재오픈은 아직 검증되지 않았습니다.
• PNG·입력fixture·저장 Markdown은 원본 바이트를 유지하고 있습니다. 보조 코드는 준비와 읽기에 사용되며, 가져오기 및 출력 파일 생성은 plugin API로 대체하지 않습니다.

준비된 profile ID 오류, 클릭 대상 selector 대기 실패, 파일 선택 시 첫 번째 Return만으로는 닫히지 않은 사실을 유지하고 있습니다. 실제 선택 확정은 OS 화면의 Open 버튼으로 진행했습니다. 앱은 GUI Close 후 실제 대기에서 0을 종료했으며, Xorg는 모든 프로세스에 SIGTERM을 입력하고 실제 대기 0이었습니다. 컨트롤러는 끝부분의 Xlib 종료 처리에서 EXIT 1로 설정되어 있으며, 전체가 정상 종료된 것은 아닙니다. 자세한 내용은 검증 기록에 정리하겠습니다.

실제 계정의 export, Notion account/API·데이터베이스·수식, Apple Notes 실행, 전체 메타데이터/전체 레이아웃/임의의의 대규모 데이터, 기타 OS, iOS, Sync, SimpleMemo, 속도·안전성·생산성의 효과는 검증되지 않았습니다.

• Importer 3.1.9 공식 릴리스
• 고정 커밋의 공식 README
• Notion 공식fixture의 원본
• Evernote 공식fixture의 원본
• Apple Notes의 고정 source・OS 조건

선정판의 source와 공식 배포물의 대조를 수행했지만, source에서 동일한 빌드를 재현한 검증은 아닙니다.

이전 후에는 노트의 수·첨부·링크·가독성을 확인하고, 필요한 본문을 수정합니다. Vault이나 노트 간 링크를 처음 사용하는 분은, 부모 가이드에서 Obsidian의 기본 조작을 확인할 수 있습니다.