Markdown 노트를 JW Library로 가져오는 방법
Obsidian, Notion 등 어떤 Markdown 편집기에서 쓴 .md 파일이든 알맞은 절에 붙은 진짜 JW Library 노트로 바꿉니다 — 무료, 비공개, 브라우저 안에서.
JW Library에는 밖에서 글을 가져올 방법이 전혀 없습니다. 앱 안에서 노트를 쓸 수는 있지만, 다른 곳에서 쓴 노트 — Obsidian, Notion, 컴퓨터의 텍스트 파일 — 는 서재로 들어올 길이 아예 없습니다. 결국 손으로 다시 옮겨 적거나, 포기하고 영원히 만나지 않는 두 벌의 연구 노트를 갖게 됩니다.
JW Sync가 그 틈을 메웁니다. 연구 탐색기에 백업을 불러오고 ‘Markdown 가져오기’를 누르면 .md 파일이 그 안의 진짜 노트가 됩니다. 제목과 날짜와 태그가 그대로 남고, 어느 성구에 속하는지 파일에 적혀 있으면 바로 그 절에 붙습니다. 읽으면서 앱에서 직접 쓴 것과 똑같습니다.
양방향으로 작동합니다. 이 사이트에서 내보낸 노트는 책·장·절을 지니고 있으므로 나왔던 자리로 정확히 돌아갑니다. 다른 곳에서 쓴 노트에는 보통 그런 정보가 없습니다. 그래서 이 페이지에서는 노트를 제자리에 놓아 주는 한두 줄과, 그 줄이 없는 파일이 어떻게 되는지를 설명합니다.
단계별 안내
JW Library에서 백업 만들기
JW Library를 열고 개인 연구로 가서 점 세 개 메뉴를 누른 뒤 백업 및 복원 → 백업 만들기를 선택하세요. .jwlibrary 파일이 생깁니다. 노트가 더해질 서재입니다.
연구 탐색기 열기
jwsync.org에 접속해 연구 탐색기를 열고 그 .jwlibrary 파일을 불러오세요. 모든 처리는 브라우저 안에서 이루어지며 파일은 어디에도 업로드되지 않습니다.
‘Markdown 가져오기’ 누르기
버튼은 ‘Markdown 내보내기’ 옆에 있습니다. .md 파일을 원하는 만큼 고르거나, 그것들을 담은 .zip을 고르세요. 이 사이트가 내보낼 때 만드는 .zip도 그대로 씁니다.
무언가 기록되기 전에 요약 읽기
몇 개가 절에 붙고, 몇 개가 독립 노트로 추가되며, 몇 개가 이미 백업에 있어 건너뛰는지 알려 줍니다. 사이트가 해석해야 했던 것은 한 줄씩 체크 상자와 함께 나열되므로, 나중에 발견하는 대신 지금 결정할 수 있습니다.
내보내고 복원하기
‘.jwlibrary 내보내기’를 누른 뒤 그 파일을 JW Library의 백업 및 복원 → 복원에서 복원하세요. 가져온 노트가 그 기기의 서재에 포함됩니다.
작동하는 가장 짧은 파일
Markdown 파일은 가져오기 위해 아무것도 필요하지 않습니다. 본문만 있는 파일도 노트가 되며, 제목은 첫 머리글에서, 없으면 파일 이름에서 가져옵니다. 나머지는 모두 노트가 어디에 속하는지 알려 주기 위한 것입니다. 완전한 파일은 이렇게 생겼습니다. --- title: 그가 기도한 잔 tags: [연구, 겟세마네] publication: Matthew 26:39 --- 그의 기도는 마지못함이 아니라 복종을 보여 준다. 두 줄의 대시 사이에 있는 부분을 front matter라고 합니다. 그 아래 줄이 노트 본문입니다.
읽어 들이는 항목
읽는 것은 다섯 가지뿐이며, 각각 여러 표기를 받아들이므로 정확한 이름을 외울 필요가 없습니다. **title**(또는 name, heading)은 노트 제목이 됩니다. **tags**(또는 tag, keywords, categories, labels, topics)는 진짜 JW Library 태그가 되며 없으면 새로 만들어집니다. **date**(또는 created, modified)는 노트 날짜를 정합니다. YYYY-MM-DD가 들어 있으면 이해합니다. **publication**(또는 pub, reference, ref, scripture, citation, source, passage)에 성구를 적습니다. **book**, **chapter**, **verse**(또는 ch, v, vs, verses)는 같은 일을 항목을 나누어 합니다. 그 밖에 여러분이 쓰는 항목 — 작성자, 상태, 편집기가 붙이는 것 — 은 오류로 취급되지 않고 그냥 무시됩니다.
노트를 절에 붙이는 세 가지 방법
한 줄로 적기: `publication: Matthew 26:39`. 나누어 적기: `book: Matthew`, `chapter: 26`, `verse: 39`. 둘 다 적기 — 이 사이트의 내보내기가 그렇게 합니다. 사람이 읽기에도 좋고 기계가 해석하기에도 정확하기 때문입니다. 셋 다 결과는 같으니 쓰시는 편집기에 맞는 방식을 고르세요.
성구 표기는 얼마나 자유로울 수 있나
책 이름은 너그럽게 대조됩니다. 정식 이름은 물론이고 실제로 사람들이 치는 약자도 통합니다. Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalms뿐 아니라 Psalm, Song of Solomon뿐 아니라 Song of Songs. 장과 절 사이 구분은 콜론이든 마침표든 v든 됩니다. `John 3:16`, `John 3.16`, `1 Cor 13 v4`는 모두 같게 읽힙니다. 공백은 어디서든 생략할 수 있어 `1Cor13:4`도 됩니다. front matter 자체도 그만큼 너그럽습니다. 항목 이름은 대문자여도 됩니다. 콜론 뒤 공백은 없어도 됩니다. 남는 공백과 탭, 값을 감싼 따옴표, 줄 끝의 # 주석은 무시됩니다. Windows 줄바꿈도 괜찮습니다. --- 줄을 아예 빼고 곧바로 항목부터 시작해도 되는데, 다만 맨 첫 줄이 인식되는 이름이어야 합니다. 이 규칙은 콜론이 들어간 평범한 문장으로 시작하는 노트가 첫 문단을 잃지 않게 하기 위한 것입니다.
태그는 어떻게 쓰든 상관없습니다
다음은 모두 같은 두 태그가 됩니다. `tags: [연구, 그리스어]`, `tags: 연구, 그리스어`, `tags: 연구; 그리스어`, `tags: #연구 #그리스어`, 또는 `tags:` 아래에 줄을 나누어 각 항목을 붙임표로 시작한 목록. 서재에 이미 있는 태그는 중복해서 만들지 않고 다시 씁니다. 그래서 가져온 노트는 평소 걸러 보던 바로 그 태그에 합류합니다.
분명하지 않을 때 어떻게 되나
확실하지 않은 것을 대신 정해 주지 않습니다. 책 이름이 실제와 비슷하지만 정확하지 않으면 — `Mathew`, `Ecclesiates` — 노트는 자동으로 놓이지 않습니다. 요약에 한 줄로 나타나 사이트가 어떻게 읽었는지 알려 줍니다. ‘Matthew 26:39 (으)로 읽었습니다’와 체크 상자가 함께 표시됩니다. 체크를 풀면 빠지고, 그대로 두면 그 줄대로 놓입니다. 책 이름을 전혀 알아보지 못하면 그렇다고 표시되고, 노트는 독립 노트로 추가됩니다. 추측에 억지로 맞추지 않습니다. 번호가 붙은 책은 번호를 지키므로 `1 Jonh`는 요한 1서로만 고쳐질 뿐, 요한 2서가 되지는 않습니다.
일부러 하지 않는 것
절 범위는 첫 절에 붙습니다. `Matthew 26:39-41`은 노트를 39절에 놓습니다. JW Library 노트는 구간이 아니라 본문의 한 지점에 붙기 때문입니다. 장은 있고 절이 없는 성구 — `Matthew 26` — 는 그 장에 붙습니다. 성구가 아니라 출판물 이름을 적은 파일 — `The Watchtower—2023 No. 4` — 은 아무것도 묻지 않고 평범한 독립 노트로 들어옵니다. 기사에서 적은 노트에 대해 이 사이트의 내보내기가 바로 그렇게 쓰기 때문입니다.
여정에서 살아남는 서식
문단, 줄바꿈, **굵게**, *기울임*, 글머리 기호 목록은 JW Library에서도 진짜 서식으로 나타납니다. 파일 맨 위의 머리글은 노트 안에서 되풀이되지 않고 제목으로 쓰입니다. Markdown은 표현할 수 있지만 JW Library 노트는 못 하는 것 — 표, 이미지, 링크, 코드 블록 — 은 글자만 남깁니다. 배치는 옮기지 못해도 말은 잃지 않습니다.
노트가 실제로 어디에 놓이는지, 그리고 왜 안전한지
노트를 절에 붙이려면 그 장에 대한 내부 식별자가 필요하며, 그것은 여러분의 서재마다 다릅니다. JW Sync는 그것을 결코 지어내지 않습니다. 그 장에 대해 여러분의 백업이 이미 갖고 있는 위치를 다시 쓰거나, 같은 파일 안의 다른 성구 위치에서 그 식별자를 복사합니다. 백업에 성서 노트나 강조 표시가 하나도 없으면 복사할 곳이 없으므로, 앱이 알아보지 못할 수도 있는 것에 붙이는 대신 독립 노트로 추가합니다. 이는 의도한 선택입니다. 조용히 엉뚱한 자리에 놓인 노트가, 붙지 않은 채 분명히 도착한 노트보다 나쁘기 때문입니다.
같은 파일을 두 번 가져오기
제목과 본문과 위치가 백업 안의 것과 일치하면 이미 있는 노트로 봅니다. 그래서 같은 내보내기를 다시 가져와도 겹치지 않습니다. 확정하기 전에 그 이유로 몇 개가 건너뛰어지는지 요약이 알려 줍니다. 가져오기가 더한 모든 것은 실행 취소 한 단계이며, 가져온 노트에는 Imported 태그가 붙어 나중에 한꺼번에 찾고 거르고 지울 수 있습니다.
자주 묻는 질문
- --- 줄을 꼭 써야 하나요?
- 아닙니다. 파일을 분명하게 해 주고 어떤 Markdown 편집기든 이해하지만, 곧바로 항목부터 시작해도 되고 — 첫 줄을 `title: …`로 — front matter 없이 첫 머리글을 제목으로 삼게 해도 됩니다.
- 책 이름을 잘못 쓰면 어떻게 되나요?
- 대개 사이트가 뜻을 알아채지만, 그것만으로 실행하지는 않습니다. 노트가 요약에 어떻게 읽혔는지와 함께 체크 상자로 나타나므로, 무엇이 기록되기 전에 확인하게 됩니다.
- Obsidian 폴더 전체를 가져올 수 있나요?
- 한 번에 원하는 만큼 .md 파일을 고르거나, 폴더를 압축해 .zip을 고르세요. 압축 안의 파일도 낱개 파일과 똑같이 읽힙니다.
- 가져오면 기존 노트를 덮어쓰나요?
- 아닙니다. 가져오기는 더하기만 합니다. 기존 노트, 강조 표시, 북마크, 태그는 그대로이고 불러온 파일도 절대 바뀌지 않습니다. 마지막에 새 .jwlibrary를 내려받습니다.
- 제 노트가 어딘가로 올라가나요?
- 아닙니다. 이 사이트의 다른 기능과 마찬가지로 전부 브라우저 안에서 돌아갑니다. 백업도 Markdown 파일도 기기를 떠나지 않습니다.
- 성구는 어떤 언어로 쓸 수 있나요?
- 현재 책 이름은 영어로 인식되며, 내보내기도 영어로 씁니다. 다른 언어로 노트를 쓰신다면 `book`, `chapter`, `verse` 항목에 영어 책 이름을 넣거나, 붙이지 않은 채 가져온 뒤 나중에 직접 옮기세요.
- 노트를 다시 꺼낼 수 있나요?
- 네 — 같은 화면의 ‘Markdown 내보내기’가 각 노트를 같은 항목이 담긴 .md 파일로 씁니다. 노트는 JW Library를 나갔다가 제자리를 잃지 않고 돌아올 수 있습니다.