Obsidian 개발사의 CEO가 AI용 사용 설명서를 무료로 공개했습니다.
여기에서 확인할 수 있습니다:
https://github.com/kepano/obsidian-skills
텍스트 파일 5개만 들어 있습니다. 설치하는 데 5분이면 충분하고, 기존 노트를 망가뜨리지도 않습니다.
이 파일들을 추가하면 AI가 Obsidian 고유의 서식을 이해하게 됩니다. "AI가 내 노트를 엉망으로 만든다"는 문제에 대한 공식적인 해답입니다.
이게 화제가 되는 것을 보고 직접 환경을 열어 설치하려다 보니, 이미 설치되어 있더라고요...
파일 날짜가 4월 26일이었습니다. 3개월 반 전에 설치해 두고 완전히 잊고 있었던 겁니다(ㅋㅋ).
그렇다면 그 3개월 반 동안 제 Obsidian에는 무엇이 바뀌었을까요? 궁금해서 확인해 봤는데, 결과는 꽤 실망스러웠습니다.
결론부터 말하면, 공식 설명서만으로는 부족합니다. 직접 작성해야 할 페이지가 하나 더 있습니다.
AI가 모르는 것은 Obsidian 고유의 문법
Obsidian에는 일반 메모 앱과 다른 몇 가지 독특한 기능이 있습니다.
노트를 연결하려면 [[ ]]로 감쌉니다. (링크)
노트를 눈에 띄게 만들려면 특정 문법으로 색상 박스를 만듭니다. (콜아웃)
파일 맨 위에는 날짜와 태그를 넣는 섹션이 있습니다. (속성)
AI는 이런 것들을 모른 채 글을 작성합니다. 그래서 텍스트만 보면 멀쩡해도 Obsidian에서 열어 보면 링크가 연결되어 있지 않거나 박스가 나타나지 않습니다.
앞서 링크한 5개 파일이 바로 그 공백을 메워 줍니다. 구성은 다음과 같습니다:
- obsidian-markdown (링크와 박스의 올바른 문법)
- obsidian-bases (노트를 데이터베이스 표처럼 정리)
- json-canvas (노트를 선으로 연결하는 다이어그램 만들기)
- obsidian-cli (명령어로 볼트 전체 검색)
- defuddle (웹 페이지를 깔끔한 노트로 가져오기)
위 링크에서 무료로 받을 수 있습니다.
특정 AI 도구에 한정되지 않아서 Claude Code나 Codex에서도 동일하게 작동합니다.
3.5개월 동안 설치해 두었지만 바뀐 것은 거의 없었다
솔직히 그걸 발견하고 웃었습니다. 이미 그 유명한 설명서를 갖고 있었던 겁니다... 그것도 모르고 있었네요(ㅋㅋ).
다만 Claude Code에서만 작동하고 있었기 때문에, 8월 9일에 같은 5개 파일을 Codex에도 복사해 어느 쪽에서든 사용할 수 있게 해 두었습니다.
자, 여기서 핵심입니다.
3개월 반이 지난 지금, 제 Obsidian에는 무엇이 바뀌었을까요?
- 콜아웃을 사용한 노트: 1,387개 중 32개
- 데이터베이스 뷰: 1개
- 캔버스: 1개
거의 바뀐 것이 없습니다.
공식 설명서가 나쁘다는 말은 아닙니다. 당연히 내용은 잘 만들어져 있습니다.
처음 설치했을 때 사용해 보고 "오, 편리하네" 하고 끝이었습니다. 언제 사용할지 정해 두지 않았으니 당연한 결과였죠.
아무것도 바뀌지 않은 이유는 명확합니다. 공식 설명서는 "작성법"을 가르쳐 주기 때문입니다.
작성법을 안다고 해서 써 내는 콘텐츠가 늘어나지는 않습니다. 또한 무엇을 어디에 둘지도 정해 주지 않습니다.
AI에게 주는 지침에는 두 가지 유형이 있다
이 부분은 매우 중요하다고 생각합니다.
AI에게 주는 지침서에는 두 가지 유형이 있습니다.
- 올바른 Obsidian 문법. 모든 사람의 Obsidian에 동일하게 적용되므로 공식 팀이 제공합니다.
- 자신만의 내부 규칙. 무엇을 어디에 둘지. 건드려도 되는 영역. 완성된 결과물이 있어야 할 위치.
공식 팀이 제공하는 것은 전자뿐입니다.
그리고 볼트가 지저분해지는 원인은 대개 후자입니다. 문법 오류가 있는 것보다 올바르게 작성됐지만 위치가 잘못된 것이 더 문제입니다.
"내부 규칙"이 없을 때 이런 문제가 발생합니다:
- 완성된 글이 매번 다른 폴더에 저장됩니다.
- 읽기 전용으로 두고 싶은 다이어리에 AI가 글을 추가합니다.
- 폴더 이름을 바꿨는데도 새 노트가 계속 옛 이름으로 생성됩니다.
이 모든 경우에 문법은 완벽합니다. 단지 위치와 취급 방식이 잘못된 것뿐입니다.
예를 들어 공식 설명서는 "관련된 노트는 링크로 연결하세요"라고 말합니다. 맞는 말입니다.
하지만 제 규칙은 반대입니다. "나중에 반드시 열어볼" 노트만 연결하는 것입니다. 링크가 너무 많아지면 아무것도 찾을 수 없거든요.
어느 쪽이 옳고 그르냐의 문제가 아니라, 공식 가이드가 제 개별 상황을 반영할 수 없다는 뜻입니다.
AI를 아무리 많이 사용해도 자산은 저절로 늘지 않습니다. 재료는 이미 있습니다. 부족한 것은 "그릇"입니다.
공식 설명서는 그릇의 "모양"을 가르쳐 줄 뿐, 무엇을 어디에 넣을지는 직접 정해야 합니다.
━━━━━━━━━━━━
AI를 사용하는데도 콘텐츠 제작이 좀처럼 쉬워지지 않는 분들을 위해:
재료를 한곳에 모아 두면 매번 제로에서 시작하지 않아도 됩니다.
"Minami의 Obsidian x AI 에이전트 실천 로그"를 시작했습니다.
여기서 무료로 읽어 보세요 ↓
https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x
━━━━━━━━━━━━
내부 규칙을 만들 때 필요한 최소 4가지 항목
저는 Obsidian에 "운영 규칙"이라는 파일 하나를 만들어 모든 것을 적어 두었습니다. Claude와 Codex는 작업을 시작하기 전에 이 파일을 읽습니다.
최소한으로 작동하게 만드는 4가지 항목은 이렇습니다:
- 건드려도 되는 영역 vs. 읽기 전용 영역. 제 경우 다이어리, 웹 클립, 미분류 노트는 읽기 전용입니다. 가장 중요한 부분입니다.
- 완성된 결과물의 저장 위치. 위치를 고정해 두세요. X 게시물은 여기에, Note 글은 저기에. 그러면 AI가 매번 묻지 않습니다.
- 판단이 서지 않을 때의 탈출 경로. 3초 안에 결정이 안 서면 "Unsorted"에 넣습니다. 분류 때문에 막히는 일을 방지합니다.
- 규칙을 수정할 장소를 하나로 정하기. 운영 규칙을 아무 노트에나 적지 마세요. 마스터 파일 하나로 고정하세요.
특히 4번째가 중요합니다. 이것이 없으면 규칙이 여기저기에 흩어져서 어느 것이 최신 버전인지 알 수 없게 됩니다.
설치로 끝나지 않도록 매주 점검을 돌린다
아까 언급한 5개 파일 중 obsidian-cli는 명령어로 볼트 전체를 살펴볼 수 있게 해 줍니다. 고립된 노트, 태그 사용 횟수, 깨진 링크를 찾아냅니다.
유용하지만, 실행하지 않으면 작동하지 않습니다.
그래서 이 "점검"을 주간 체크로 자동 실행되게 설정했습니다. 매주 일요일 아침마다 스스로 실행되어 깨진 링크 후보와 방치된 노트 리포트를 생성합니다.
가장 큰 장점은 직접 기억해서 실행할 필요가 없다는 것입니다.
설치해 두는 것과 실제로 가동하는 것은 전혀 다른 문제입니다.
3개월 반 동안 아무것도 바뀌지 않은 채 설치만 해 두고 있던 사람이 하는 말이니, 아마 맞을 겁니다(ㅋㅋ).
결론
공식 설명서 설치는 5분이면 끝납니다. 무료이고, 노트를 망가뜨리지도 않습니다. 해서 손해 볼 일은 없습니다.
하지만 바뀌는 것은 문법뿐입니다.
Obsidian을 AI에 맡겨 두면 지저분해지는 이유는 여러분이 사용을 잘 못해서가 아닙니다. 단지 AI가 읽을 수 있는 "내부 규칙" 파일이 아직 없을 뿐입니다.
그러니 위임하기 전에 모든 것을 외워야 한다고 부담 가질 필요가 없습니다. 공식 팀이 문법을 제공합니다. 여러분이 작성할 것은 단 한 페이지입니다.
오늘 바로 시작한다면, AI가 건드려도 되는 곳과 건드리면 안 되는 곳을 나누는 한 줄부터 적어 보세요. "다이어리 폴더는 읽기 전용이니 다시 작성하지 마세요"라는 한 줄이면 충분합니다.
그 한 줄만으로도 AI 작업 이후에 수정해야 할 양이 크게 줄어듭니다.
━━━━━━━━━━━━
끝까지 읽어 주셔서 감사합니다!
공지 📢
오픈 채팅을 운영하고 있습니다!
"Obsidian 사용자"를 늘리는 것을 목표로, X에는 올리지 않는 Obsidian x AI 에이전트 이야기를 매일 공유하고 있습니다.
선물도 나눠 드리고 있으니, 관심이 있으시면 확인해 보세요 ↓
