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