고립 Markdown 문서 탐지기

고립 Markdown 문서 탐지기 사용 가이드

문서 사이트나 위키를 오래 운영하면 목차에서 빠져 아무 데서도 들어갈 수 없는 문서, 지운 파일을 여전히 가리키는 링크가 쌓입니다. 이 탐지기는 선택한 Markdown 파일들의 .md 링크를 모두 읽어 이런 문서와 링크를 한 번에 찾아 줍니다.

첫 번째로 선택된 파일을 시작 문서(보통 index.md나 README.md)로 보고, 나머지 문서 중 다른 문서의 링크 대상이 한 번도 되지 않은 것을 '고립 문서'로 표시합니다. 링크 대상 파일이 선택 목록에 없으면 '깨진 링크'로 모읍니다.

브라우저는 폴더 이름을 알려 주지 않으므로 docs/guide.md 같은 경로도 파일 이름으로 비교하고, faq.md#요금처럼 # 뒤 절 이름은 떼고 봅니다.

사용 방법

1. 1'Markdown 파일'에서 시작 문서(index.md 등)를 포함해 문서 폴더의 .md 파일을 모두 고릅니다.
2. 2'실행'을 누르면 시작 문서, 고립 문서, 깨진 링크 목록이 나옵니다.
3. 3고립 문서는 목차나 관련 문서에 링크를 추가하고, 깨진 링크는 파일 이름을 고치거나 링크를 지웁니다.

선택한 파일: index.md, guide.md, faq.md, draft.md

index.md 내용:
[가이드](docs/guide.md)
[FAQ](faq.md#요금)
[예전](old-intro.md)

시작 문서: index.md
고립 문서: draft.md
깨진 링크: old-intro.md

이럴 때 쓰면 좋아요

• 문서 사이트의 목차에서 빠진 페이지를 찾을 때
• 파일을 정리한 뒤 남은 깨진 내부 링크를 확인할 때
• 위키 이전 전에 쓸모없는 고립 문서를 골라낼 때
• 새로 쓴 문서가 다른 문서에서 연결됐는지 점검할 때

문제가 생겼을 때

활용 팁

• 고립 문서가 꼭 필요 없는 문서는 아닙니다. 검색으로만 찾는 참고 문서라면 관련 문서 끝에 '함께 보기' 링크를 하나 걸어 두세요.
• 문서 간 연결 전체를 보려면 같은 파일들로 Markdown 문서 링크 그래프를 실행하세요.

자주 묻는 질문