노트 이름을 바꿀 때 링크가 깨지지 않게 하는 법
노트 파일명 10개와 폴더 이동 기록을 대조해, 당시 확인한 줄 수·경로·참조 검사와 추가로 필요한 해시 검사를 구분했다. 리터럴 치환이 놓치는 링크와 표시 제목도 짚는다.

파일 탐색기에서 노트 이름을 정리하고 나면, 다른 노트에 남은 옛 링크가 마음에 걸릴 수 있다. 2026년 7월의 정리 기록에서도 이름을 바꾼 파일은 10개였지만, 참조를 고친 파일은 34개였고 치환한 곳은 71곳이었다. 외부에서 이름을 바꿨다면 새 파일의 존재뿐 아니라 옛 이름의 참조와 표시 제목까지 확인해야 한다. 이 글은 파일명 축약과 폴더 이동 기록을 나눠 살피며, 당시 검사와 추가로 권하는 검사를 구분한다.
일반적인 이름 변경이라면 먼저 노트 앱의 기능을 쓰는 편이 간단하다. Obsidian은 파일 이름 변경 시 내부 링크를 갱신하는 기능을 제공하며, 설정의 파일 및 링크 항목에서 자동 갱신 여부를 정할 수 있다. 여기서 다루는 사례는 앱 안의 이름 변경이 아니라 외부 스크립트로 파일을 이동하고 참조를 치환한 작업이다. 앱의 자동 갱신과 외부 파일 이동은 링크를 처리하는 경로가 다르다.
새 이름의 파일이 존재하는 것과, 그 파일을 가리키는 링크·별칭·표시 제목이 맞는 것은 따로 확인해야 한다.
이름 변경과 폴더 이동은 따로 다뤘다
첫 작업의 목적은 새로 정한 이름 규칙을 기존 학습 노트에도 적용하는 것이었다. 725개 파일과 85개 폴더를 검토했고, 파일명 10개만 축약했다. 폴더명은 이미 간결해 변경하지 않았으며, 파일이 속한 폴더 구조도 유지했다. 변경 대상은 이전 이름과 새 이름의 대응표로 남았다.
두 번째 작업은 구체적인 기술 주제 폴더를 더 큰 주제 폴더 아래로 옮기는 일이었다. 이동 대상 파일 6개를 유지하고, 상위 주제의 인덱스와 허브를 추가했다. 경로 문자열을 리터럴 치환한 결과는 6개 파일 변경, 30회 치환이었다. 이름 축약에서는 파일명 대응을, 폴더 이동에서는 새 위치와 상위 연결을 함께 확인할 필요가 있었다.
줄일 이름과 남길 이름
파일명 검토에서 축약 대상으로 고른 10건은 문장형 표현·중복어·워크플로 상태어를 포함한 19–27자 수준의 이름이었다. 반면 약 18자여도 주제나 단어를 나열한 이름은 규칙 위반으로 보지 않았다. 정렬에 쓰는 번호 접두어는 유지하고 뒤의 텍스트를 줄였다. 길이만으로 자르는 기준이 아니라 이름에 담긴 정보의 성격을 구분한 것이다.
예를 들어 01_자료정리_검증대기.md를 01_자료정리.md로 바꾸는 것은 설명을 위한 예시다.
번호는 남기고 상태만 떼는 방식이다.
실제 이름 변경 전에는 같은 이름을 쓰는 파일이 다른 폴더에 있는지, 줄이려는 단어가 검색에 필요한 정보인지부터 확인할 필요가 있다.
짧아졌다는 사실만으로 더 좋은 이름이 되지는 않는다.
리터럴 치환이 놓치는 참조
당시 작업에서는 버전 관리 명령을 쓰지 않고 일반 파일시스템 이동으로 이름과 위치를 바꿨다.
파일명 정리의 참조 수정에는 확장자를 뺀 이전 이름인 stem을 새 stem으로 바꾸는 Python str.replace를 사용했다.
정규식 패턴을 해석하지 않는 리터럴 치환으로 위키링크·마크다운 링크·frontmatter의 aliases와 title을 함께 처리했다.
볼트 전체를 대상으로 설정·관리용 영역 등을 제외한 8,623개 md 파일을 스캔했고, 34개 파일의 참조 71곳을 바꿨다.
리터럴 치환은 일치하는 문자열을 바꾸지만 링크 대상을 이해하지는 않는다.
회의록처럼 흔한 이름을 볼트 전체에서 바꾼다면 다른 폴더의 동명 파일이나 본문 문장까지 바뀔 수 있다.
같은 이름의 파일이 있다면 폴더 경로를 포함해 대상을 좁혀야 한다.
마크다운 링크에서 공백이 %20으로 표기된 경우처럼 화면 이름과 저장 문자열이 다른 경우도 별도로 확인한다.
이는 이번 기록에서 실행됐다고 확인되는 검사가 아니라, 같은 방식을 적용할 때 추가로 권하는 확인이다.
같은 방식을 적용할 때 별칭과 표시 제목까지 무조건 바꾸는 것은 권하지 않는다.
aliases는 이전 이름으로도 검색하려고 일부러 남겨 둘 수 있고, title은 파일명과 다른 제목일 수 있다.
옛 문자열이 남아 있다는 이유만으로 지우지 말고, 링크 대상인지 표시용 이름인지 구분한다.
당시 확인한 것과 추가로 확인할 것
파일명 10개를 바꾼 작업 기록에는 이동 전후 줄 수 일치, 옛 경로 부재와 새 경로 존재가 남아 있다. 8,623개 md 파일을 다시 스캔한 결과 이전 파일명 stem의 잔여 참조는 0건이었다. 당시 해시를 비교했다는 기록은 없다. 줄 수가 같아도 같은 줄 안의 글자가 달라질 수 있으므로, 줄 수 일치만으로 바이트 단위의 내용 보존을 입증할 수는 없다.
| 확인 대상 | 당시 확인 범위 | 추가로 권하는 검사 |
|---|---|---|
| 파일 내용 | 이름을 바꾼 10개 파일의 줄 수 일치 | 이름만 바꾼 단계에서 원본 복사본과 SHA-256 해시 비교 |
| 이동 결과 | 옛 경로 없음, 새 경로 있음 | 새 경로의 동명 파일을 덮어쓰지 않았는지 확인 |
| 이전 이름 | 8,623개 md 파일 재검색에서 이전 파일명 참조 0건 | 남겨야 할 별칭과 본문 설명은 의도된 예외로 구분 |
| 링크와 화면 | 별도 폴더 이동 작업에서 링크 검사와 두 번째 검토 실시 | 실제 링크 열기, 상위 경로 표기와 인덱스 제목 대조 |
다음 명령은 macOS에서 두 복사본의 해시를 비교하는 예다. 경로는 실제 백업 파일과 변경된 파일로 바꾼다. 두 줄의 해시값이 같은지 비교하며 파일명 자체는 달라도 된다.
shasum -a 256 '변경 전 복사본.md' '바뀐 이름.md'
참조나 frontmatter까지 수정한 뒤라면 해시가 달라지는 것이 정상일 수 있다. 이름만 바꾼 단계의 내용 보존과 그 뒤의 의도된 본문 수정을 나눠 확인해야 한다. 백업 없이 나중 파일끼리 비교하는 것으로 이동 전 내용까지 증명할 수는 없다.
링크가 열려도 이름표는 틀릴 수 있다
폴더 이동 작업의 두 번째 검토에서는 첫 검토가 놓친 세 가지가 발견됐다. 상위 위치를 적은 breadcrumb, 인덱스에서 허브로 연결하는 관례 위반, 표시 제목 불일치였다. 특히 상위 경로 표기는 치환에 사용한 리터럴 패턴과 맞지 않아 수동 교정이 필요했다. 옛 폴더 문자열을 바꾸는 것만으로는 상위 연결과 노트의 역할까지 맞춰지지 않았다.
수정 후에는 이동 폴더 안의 파일 6개가 유지됐고, 상위 주제의 최종 파일 수는 8개로 확인됐다. 파일 8개에 걸친 위키링크 23개를 검사한 결과 깨진 링크는 0건이었다. 서로 다른 벤더의 비저자 검증 경로가 맡은 독립 검증 두 건도 수정 후 모두 통과했다고 기록돼 있다. 이는 사람이 같은 문서를 두 번 읽었다는 서술이 아니라, 작성과 분리된 검증 결과다.
깨진 링크가 없다는 결과만으로 이름표와 분류까지 맞다고 볼 수는 없다. 존재하는 파일을 가리키더라도 의도한 허브가 아닐 수 있고, 링크는 새 위치를 열면서 표시 제목은 옛 분류를 말할 수 있다. 따라서 외부에서 파일을 옮겼다면 옛 경로의 잔여 참조 검사와 함께 상위 연결·표시 제목을 대조하는 편이 좋다.
어떤 메모를 정리 노트로 승격할지와 이름을 어떻게 바꿀지는 별도 판단이다. 이름 변경과 분류 변경을 나눠 두면 어떤 수정 때문에 참조가 달라졌는지 추적하기 쉽다. 파일 이동을 마칠 때는 새 경로의 존재와 함께, 그 노트를 찾아가는 링크와 이름표가 같은 위치를 설명하는지 확인한다.
아직 댓글이 없습니다.