JW Library로 가져올 수 있는 Markdown 파일 작성법
메모장, TextEdit, Obsidian에서 쓴 노트를 JW Library의 알맞은 성구에 얹는 방법. 정확히 어떤 줄을 입력하면 되는지, 그리고 무엇을 빼도 되는지 설명합니다.
JW Sync는 Markdown 파일을 JW Library 백업 안으로 읽어 들일 수 있습니다. 그 기능이 있다는 걸 알고 나면 정말 중요한 질문은 하나뿐입니다. 그 파일은 어떻게 생겨야 하나? 이 페이지는 쓰는 쪽에서 그 질문에 답합니다. 가져오기가 무엇을 받아 주는지가 아니라, 당신이 실제로 무엇을 입력하는지입니다.
짧게 말하면 노트는 텍스트 파일입니다. 파일을 만들고, 노트를 쓰고, 끝을 .md로 해서 저장하면 그대로 가져와집니다. 나머지는 전부 선택 사항인 한 줄에 대한 이야기입니다. 그 노트가 어느 성구에 속하는지 알려 주는 줄인데, 그 줄이 있으면 노트가 다른 노트들 사이에 따로 놓이는 대신 JW Library에서 그 성구를 읽는 동안 나타납니다.
여기에는 Markdown 편집기가 필요 없고, Markdown을 배울 필요도 없습니다. Windows의 메모장과 Mac의 TextEdit이면 충분합니다. 이미 Obsidian이나 Notion에 연구 노트를 두고 있다면 그 파일들은 이미 Markdown입니다. 아래에 각각을 다룬 부분이 있습니다.
단계별 안내
아무 일반 텍스트 편집기나 엽니다
Windows의 메모장, Mac의 TextEdit, 아니면 이미 쓰고 있는 Markdown 앱이면 됩니다 — Obsidian, Typora, iA Writer, Joplin. 피해야 할 것은 워드프로세서뿐입니다. Word와 Google 문서는 일반 텍스트 대신 서식과 레이아웃을 저장하며, 둘 다 가져오기가 읽을 수 있는 파일을 만들지 못합니다.
노트를 입력합니다
첫 줄에 # 을 붙여 제목을 쓰고, 한 줄 비운 다음, 그 아래에 노트를 씁니다. 이것만으로 이미 완전하고 유효한 파일입니다. 제목 줄을 쓰고 싶지 않다면 대신 파일 이름이 쓰입니다.
끝에 .md를 붙여 저장합니다
이름은 마음대로 지어도 됩니다 — 내 노트.md처럼요. Windows에서는 먼저 ‘파일 형식’을 ‘모든 파일’로 바꾸지 않으면 메모장이 .txt로 저장하는데, 이것이 가장 흔한 실수입니다. Mac에서는 저장하기 전에 포맷 메뉴에서 일반 텍스트로 만들기를 고릅니다.
성구에 얹어 주는 줄을 넣습니다
파일 맨 위, 다른 무엇보다 앞에, 하이픈 세 개짜리 줄, 그다음 publication: Matthew 26:39, 그리고 다시 하이픈 세 개를 씁니다. 이제 노트는 그 성구에 붙었습니다. 이 줄을 빼도 노트는 가져와집니다 — 다만 아무 데도 붙지 않은 채 들어올 뿐입니다.
백업으로 가져옵니다
JW Library에서 개인 연구로 가서 점 세 개 메뉴를 열고 백업 및 복원을 골라 백업을 만듭니다. 그 파일을 jwsync.org의 연구 탐색기에 불러온 뒤 ‘Markdown 가져오기’를 누르고 .md 파일을 고른 다음, 무엇이든 기록되기 전에 보여 주는 요약을 읽습니다. 그런 다음 ‘.jwlibrary 내보내기’를 누르고 그 파일을 JW Library에서 복원합니다.
작동하는 가장 짧은 파일
텍스트밖에 없는 파일도 이미 유효한 노트입니다. 이게 전부입니다.
# 그가 기도한 잔 그의 기도는 마지못함이 아니라 복종을 보여 준다.
# 으로 시작하는 줄이 노트 제목이 되고, 그 아래 전부가 노트 본문이 됩니다. 이 파일은 아무 불평 없이 가져와집니다. 다만 성구에 붙지 않은 독립 노트로, 다른 노트들 사이에 놓일 뿐입니다.
Windows에서 파일 만들기
메모장을 열고 노트를 입력한 다음 파일, 다른 이름으로 저장을 고릅니다. 저장하기 전에 ‘파일 형식’을 ‘텍스트 문서’에서 ‘모든 파일’로 바꾸세요 — 이 단계를 건너뛰면 메모장이 조용히 .txt를 붙여 내 노트.md.txt가 되고, 가져오기는 그 파일을 보지 못합니다. 그런 다음 .md로 끝나는 이름을 입력합니다. Windows가 확장자를 바꾸면 파일을 쓸 수 없게 될 수 있다고 경고할 수 있는데, 그 경고야말로 제대로 했다는 표시입니다.
Mac에서 파일 만들기
TextEdit을 열고 아무것도 입력하기 전에 포맷, 일반 텍스트로 만들기를 고릅니다. TextEdit은 서식 있는 텍스트 모드로 시작해 .rtf로 저장하는데, 그것은 애초에 텍스트 파일이 아닙니다. 일반 텍스트 모드가 되면 파일, 저장을 고르고 이름을 .md로 끝냅니다. macOS가 .txt를 붙여 주겠다고 하면 거절하세요.
휴대전화나 태블릿에서 파일 만들기
Markdown을 저장하거나 내보낼 수 있는 앱이면 무엇이든 됩니다 — Obsidian, Bear, iA Writer, Joplin, Android의 Markor 등. iPhone과 Android에 기본으로 들어 있는 메모 앱은 대개 .md 파일을 저장하지 못하므로, 휴대전화에서는 그런 앱을 쓰거나 그냥 컴퓨터에서 쓰는 것이 보통입니다. 가져올 때는 원하는 만큼 파일을 한 번에 고를 수 있고, 폴더 전체를 압축해 하나의 .zip으로 건네도 됩니다.
노트를 성구에 얹는 단 한 줄
노트가 어디에 속하는지 가져오기에 알려 주는 것은 모두 파일 맨 위, 하이픈 세 개짜리 두 줄 사이의 작은 덩어리에 들어갑니다. 이것을 front matter라고 하며, 대부분의 노트에서는 한 줄이면 충분합니다.
--- publication: Matthew 26:39 --- # 그가 기도한 잔 그의 기도는 마지못함이 아니라 복종을 보여 준다.
이 노트는 이제 마태 26:39에 붙었습니다. 그 성구를 읽는 동안 JW Library에 나타납니다 — 앱 안에서 거기에 직접 쓴 것과 똑같이요.
알아들을 수 있게 성구를 적는 법
책 이름은 영어로 쓰세요. 노트 본문이 다른 언어여도 마찬가지입니다 — 마태가 아니라 Matthew입니다. 사람들이 실제로 입력하는 약자도 알아듣습니다 — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. 장과 절 사이에는 콜론, 마침표, 또는 문자 v를 쓸 수 있어서 John 3:16, John 3.16, 1 Cor 13 v4는 모두 같은 뜻이고, 공백은 없어도 되므로 1Cor13:4도 괜찮습니다. Matthew 26:39-41 같은 범위는 노트를 첫 절인 39절에 놓습니다. JW Library 노트는 구간이 아니라 본문의 한 지점에 붙기 때문입니다.
제목과 날짜와 태그가 있는 완전한 파일
원한다면 세 줄을 더 쓸 수 있고, 전부 선택 사항입니다.
--- title: 그가 기도한 잔 date: 2026-08-15 tags: [연구, 겟세마네] publication: Matthew 26:39 --- 그의 기도는 마지못함이 아니라 복종을 보여 준다.
title은 # 제목과 같은 일을 하므로 둘 중 하나면 됩니다. date는 가져온 날 대신 노트의 날짜를 정합니다. tags는 걸러 볼 수 있는 진짜 JW Library 태그가 되고, 이미 있는 태그는 중복되지 않고 그대로 쓰입니다. tags 줄은 대괄호 없이 연구, 겟세마네로 써도 되고, #연구 #겟세마네로 써도 되고, 아래에 줄을 나눠 하이픈 목록으로 써도 됩니다 — 네 가지 모두 같게 읽힙니다.
파일 하나에 노트 하나
.md 파일 하나가 노트 하나가 됩니다. 한 파일에 여러 노트를 담아 갈라지게 할 방법은 없습니다. Markdown 파일 안에는 한 노트가 어디서 끝나고 다음이 어디서 시작하는지 믿을 만하게 표시하는 것이 없기 때문입니다 — 중간의 제목은 두 번째 노트일 수도, 첫 노트의 소제목일 수도 있고, 잘못 짚으면 쓴 글이 흩어집니다. 그러니 노트마다 파일을 따로 만들고, 가져올 때 한꺼번에 고르거나 폴더를 압축해 .zip을 고르세요.
그대로 도착하는 서식
단락, 줄바꿈, 굵게, 기울임, 글머리 기호 목록은 JW Library에 진짜 서식으로 도착합니다. 첫 번째 다음의 제목들은 보통 단락이 됩니다. Markdown으로는 표현되지만 JW Library 노트로는 안 되는 것 — 표, 이미지, 링크, 코드 블록 — 은 글자만 남기고 줄여지므로, 배치가 따라가지 못하는 곳에서도 말은 살아남습니다.
이미 Obsidian에서 쓰고 있다면
Obsidian 파일은 이미 Markdown이고, 속성 패널이 여기서 설명한 front matter를 그대로 씁니다. publication이라는 속성에 Matthew 26:39라는 값을 넣으면 노트는 거기에 놓입니다. Obsidian 자체의 tags 속성은 tags로 읽힙니다. 이중 대괄호 링크와 끼워 넣은 노트는 글자만 남습니다. JW Library 노트에는 그것들이 가리킬 곳이 없기 때문입니다. 폴더 하나 분량의 .md를 한 번에 고를 수도 있고, 폴더를 압축해 .zip을 건넬 수도 있습니다.
이미 Notion에서 쓰고 있다면
Notion은 Markdown으로 내보낼 수 있습니다. 페이지 메뉴를 열고 내보내기를 고른 뒤 ‘Markdown & CSV’를 선택하세요. 나오는 것은 .zip이고, 가져오기는 그대로 받아들입니다. Notion은 페이지 제목을 제목으로, 자체 속성을 그 아래 보통 줄로 씁니다. 가져오기가 모르는 항목은 오류로 취급되지 않고 무시되므로, 노트를 성구에 얹으려면 내보낸 파일 맨 위에 publication 줄을 직접 넣으면 됩니다.
정확히 맞추지 않아도 되는 것들
항목 이름의 대소문자는 상관없습니다. 콜론 뒤의 공백은 없어도 됩니다. 남는 공백과 탭은 무시되고, 값을 감싼 따옴표나 # 뒤에 쓴 주석도 마찬가지입니다. Windows 줄바꿈도 괜찮습니다. --- 줄을 아예 빼고 항목부터 파일을 시작해도 되는데, 맨 첫 줄이 그중 하나이기만 하면 됩니다. 그리고 책 이름을 잘못 써도 — Mathew처럼 — 가져오기는 그것을 Matthew 26:39로 읽었다고 알려 주고 당신이 체크할 때까지 기다립니다. 혼자 결정하지 않습니다.
가져오기가 당신의 서재에 하지 않는 일
가져오기는 더하기만 합니다. 백업에 이미 있는 노트, 강조 표시, 책갈피, 태그는 건드리지 않으며, 불러온 파일이 고쳐지는 일도 없습니다 — 마지막에 새 .jwlibrary를 내려받아 그것을 복원합니다. 제목과 본문과 위치가 백업에 이미 있는 것과 모두 같은 노트는 건너뛰므로, 같은 파일을 두 번 가져와도 아무것도 겹치지 않습니다. 가져오기가 더한 것은 전부 실행 취소 한 번이면 되고, 가져온 노트에는 Imported 태그가 붙어 나중에 찾거나 걸러 보거나 한꺼번에 지울 수 있습니다. 그 어느 것도 기기 밖으로 나가지 않습니다.
자주 묻는 질문
- 먼저 Markdown을 배워야 하나요?
- 아닙니다. 평범한 문장들로 된 파일이 이미 유효한 노트입니다. Markdown은 굵게, 기울임, 글머리 기호를 원할 때만 등장하고, 그마저도 굵게는 단어를 별표 두 개로 감싸는 것, 글머리 기호는 줄 앞에 하이픈을 놓는 것이 전부입니다.
- 파일 이름이 중요한가요?
- 파일에 제목이 없을 때만 그렇습니다. title: 줄도 # 제목도 없으면 파일 이름을 다듬어 대신 쓰므로, 그가-기도한-잔.md는 ‘그가 기도한 잔’이라는 노트가 됩니다. 그 밖에는 이름을 마음대로 지어도 됩니다.
- 실수로 .txt로 저장했다면요?
- .md로 끝나도록 이름을 바꾸고 다시 가져오면 됩니다 — 내용은 하나도 바꿀 필요가 없습니다. Windows에서는 먼저 파일 탐색기의 보기 메뉴에서 파일 확장명을 켜야 할 수도 있습니다. 그러지 않으면 끝부분이 감춰져 있습니다.
- 책 이름을 제 언어로 써도 되나요?
- 지금은 안 됩니다. 책 이름은 영어로 인식되며, 이 사이트의 Markdown 내보내기도 그렇게 씁니다. 노트 본문은 원하는 언어로 쓰세요. 영어 이름이 필요한 것은 성구 줄뿐입니다. 그게 싫다면 성구 줄을 빼고 나중에 손으로 위치를 정하면 됩니다.
- 한 파일에 노트를 여러 개 넣어도 되나요?
- 안 됩니다 — 파일 하나가 노트 하나가 됩니다. 한 번 가져올 때 원하는 만큼 파일을 고르거나, 폴더를 압축해 .zip을 고르세요.
- 이미 있는 노트가 바뀌나요?
- 아닙니다. 가져오기는 더하기만 합니다. 기존 노트는 건드리지 않고, 불러온 백업도 결코 고쳐지지 않습니다. 마지막에 새 파일을 내려받고, 복원할지는 당신이 정합니다.
- 성구 줄을 빼면 어떻게 되나요?
- 노트는 그래도 가져와집니다. 성구에 붙는 대신 서재 안의 독립 노트로 들어옵니다 — 연설이나 대화, 개인적인 생각에 대한 노트라면 대개 그편이 오히려 알맞습니다.