마크다운(Markdown)은 문서 작성에 널리 사용되지만, 파일 경로가 변경되면 링크가 깨지는 고질적인 문제가 있었습니다. 이러한 불편함을 해결하기 위해 'Darnlink'라는 새로운 도구가 등장했습니다. Darnlink는 파일의 UUID(범용 고유 식별자)를 기반으로 링크를 관리하여, 파일이 이동하거나 이름이 바뀌어도 링크가 자동으로 복구되도록 돕습니다.
Darnlink의 작동 방식은 간단합니다. 문서 폴더를 지정하면, Darnlink는 모든 링크를 스캔하여 대상 파일의 프론트매터(frontmatter)에 UUID를 기록하고, 원본 링크 옆에는 이 UUID를 포함하는 숨겨진 HTML 주석을 추가합니다. 이렇게 되면 링크는 파일의 경로가 아닌 고유한 '정체성'에 고정됩니다. 이후 파일이 이동하거나 이름이 변경되어 링크 경로가 무효화되더라도, Darnlink를 다시 실행하면 UUID를 통해 대상 파일을 찾아 경로를 자동으로 업데이트하여 링크를 복구합니다. 이 과정은 결정론적(deterministic)이며, 별도의 데이터베이스나 인덱스 파일 없이 작동합니다.
이 도구는 특히 복잡하게 중첩된 마크다운 문서 트리를 관리하는 개발자들에게 유용합니다. 문서 리팩토링(refactoring) 전후에 Darnlink를 실행하기만 하면 링크 깨짐 걱정 없이 문서 구조를 변경할 수 있습니다. 또한, `pre-commit` 훅이나 깃허브 액션(GitHub Actions)과 같은 CI/CD 파이프라인에 통합하여, 깨진 링크가 커밋되거나 배포되는 것을 사전에 방지하는 품질 게이트(quality gate) 역할을 수행할 수도 있습니다. 이는 문서의 신뢰성을 높이고 개발 워크플로우를 더욱 효율적으로 만들 중요한 변화입니다.