문제 패널은 글을 쓰는 동안 놓치기 쉬운 문제들, 그중에서도 특히 더 이상 존재하지 않는 대상을 가리키는 링크와 이미지를 프로젝트에서 검사합니다. 이 패널은 창 하단에 도킹되어 있으며, 터미널 및 찾기 패널과 같은 영역을 공유합니다.
문제 패널 열기
맨 왼쪽 활동 표시줄에서 문제 아이콘을 클릭하면 패널이 표시되거나 숨겨집니다. 처음 열면 검사를 시작할 수 있는 참조 검사 카드가 나타납니다.
참조 검사
참조 검사는 프로젝트의 모든 Markdown 파일을 검사하여 확인할 수 없는 참조를 보고합니다. 다음 항목을 찾아냅니다.
- 파일을 찾을 수 없음 — 링크나 이미지가 존재하지 않는 파일을 가리키는 경우(예: 이름이 변경되었거나 삭제된 파일)
- 제목을 찾을 수 없음 —
#anchor링크가 대상 문서에 없는 제목을 가리키는 경우 - 연결할 수 없는 외부 URL — 선택적으로, 오류를 반환하는 외부 링크를 HTTP 상태와 함께 표시
참조 검사 카드에서 또는 메뉴의 도구 > 참조 검사에서 검사를 시작합니다. 검사가 실행되는 동안 패널에 진행 상황이 표시되며, 완료되면 결과가 파일별로 묶여 나타납니다.
결과 읽기
문제가 있는 각 파일은 트리에서 하나의 그룹이 되며, 이를 펼치면 해당 파일의 모든 끊어진 참조가 나열됩니다. 각 항목에는 다음이 표시됩니다.
- 참조가 나타나는 줄 번호
- 문서에 작성된 그대로의 참조 텍스트
- 짧은 사유 — “파일을 찾을 수 없음”, “제목 … 을(를) 찾을 수 없음”, 또는 연결할 수 없는 URL의 HTTP 상태
항목을 클릭하면 해당 파일이 열리고 해당 줄로 이동하여 문제를 수정할 수 있습니다. 수정한 후에는 다시 검사를 사용해 검사를 다시 실행하고 문제가 해결되었는지 확인하세요.
사용 시점
참조 검사는 문서를 게시하거나 공유하기 전, 파일 이름을 변경하거나 재구성한 후, 또는 문서 간에 내용을 옮긴 경우에 가장 유용합니다. 이는 확인되지 않는 링크를 클릭했을 때 나타나는 인라인 끊어진 링크 알림을 보완합니다. 문제 패널은 그러한 문제를 하나씩이 아니라 프로젝트 전체에서 한 번에 모두 찾아냅니다.