링크 및 미디어

MarkNode는 문서 안의 모든 링크와 이미지를 상호작용 가능한 참조로 다룹니다. 링크 위에 마우스를 올려 이동할 위치를 확인하고, 수정자 키를 누른 채 클릭해 열고, 클립보드에서 이미지를 바로 붙여넣고, 로컬 파일을 파일 탐색기에서 표시할 수 있습니다 — 모두 편집기를 벗어나지 않고 가능합니다.

링크에 마우스 올리기

미리보기 창에서 링크나 이미지 위에 마우스를 올리면 아래쪽 가장자리를 따라 얇은 띠에 대상 위치가 표시됩니다. 로컬 참조는 프로젝트 루트를 기준으로 한 상대 경로(./docs/install.md)로 표시되어 알아보기 쉽고, 외부 링크는 전체 URL로 표시됩니다.

링크 열기

클릭 동작은 어디를 클릭하는지, 그리고 어떤 수정자 키를 누르고 있는지에 따라 달라집니다:

  • 미리보기에서 — 그냥 클릭하면 링크가 열립니다. 외부 URL(http, https, mailto)은 기본 브라우저에서 열립니다. 프로젝트 내 다른 마크다운 파일로의 링크는 편집기에서 열립니다. 그 밖의 로컬 파일(PDF, 이미지, 스프레드시트)은 파일 탐색기 사이드바에서 표시되며, 프로젝트 외부에 있는 경우에는 시스템 파일 관리자에서 표시됩니다.
  • 편집기에서 — 그냥 클릭하면 일반 마크다운 텍스트처럼 커서가 놓입니다. 링크를 따라가려면 수정자 키 — macOS에서는 Cmd, Windows와 Linux에서는 Ctrl — 를 누른 채 클릭하세요. 동일한 대상 규칙이 적용됩니다.
  • 해시 앵커#anchor 형태의 링크는 현재 문서에서 일치하는 제목으로 이동합니다. ./guide.md#setup과 같은 파일 간 앵커는 해당 파일을 열고 그 제목까지 스크롤합니다.

깨진 로컬 링크(파일이 존재하지 않는 경우)를 클릭하면 MarkNode는 아무 반응 없이 넘어가는 대신 짧은 오류 알림을 표시합니다.

우클릭 메뉴

링크나 이미지를 우클릭하면 링크 종류에 따라 항목이 달라지는 컨텍스트 메뉴가 열립니다:

  • 외부 URL의 경우: 브라우저에서 URL 열기URL 복사.
  • 로컬 파일의 경우: 파일 열기(마크다운 파일), 파일 탐색기에서 표시(MarkNode 사이드바에서 해당 파일 선택), Finder에서 보기 / 탐색기에서 보기 / 파일에서 보기(해당 파일이 선택된 상태로 시스템 파일 관리자 열기), 파일 경로 복사, 그리고 모든 참조 찾기(마크다운 파일의 경우, 대상으로 연결되는 모든 위치를 프로젝트에서 검색 — 결과는 하단 패널에 표시됩니다).
  • #anchor 링크의 경우: 열기링크 복사.

표시 수정자 키

macOS에서는 Cmd+Alt, Windows와 Linux에서는 Ctrl+Alt를 누른 채 로컬 링크를 클릭하면 링크를 여는 대신 대상을 파일 탐색기 사이드바에서 표시합니다. 파일을 어떻게 할지 결정하기 전에 프로젝트 내 어디에 있는지 확인하고 싶을 때 유용합니다.

이미지 붙여넣기

이미지를 복사한 뒤 — 예를 들어 스크린샷이나 브라우저에서 가져온 이미지 — Cmd+V(Windows/Linux: Ctrl+V)로 편집기에 붙여넣으면 MarkNode는 다음을 수행합니다:

  1. 이미지를 프로젝트의 미디어 폴더(기본값 media/)에 저장합니다.
  2. 이름 충돌이 없도록 pasted-1715680222.png와 같이 타임스탬프가 붙은 파일 이름을 생성합니다.
  3. 커서 위치에 상대 경로 마크다운 이미지 링크를 삽입합니다.

세 단계 흐름: 클립보드에 있는 이미지를 Cmd+V로 붙여넣으면, MarkNode가 프로젝트의 미디어 폴더 안에 타임스탬프가 붙은 파일로 저장하고, 커서 위치에 상대 경로 마크다운 이미지 링크가 삽입됩니다.

미디어 폴더가 없으면 처음 붙여넣을 때 생성됩니다. MarkNode가 사용할 폴더는 설정 > 일반 > 이미지 가져오기에서 변경할 수 있습니다 — “프로젝트 내 기본 폴더”를 설정하거나 문서와 같은 폴더에 이미지를 저장하도록 선택하세요.

클립보드에 텍스트와 이미지가 모두 들어 있으면 텍스트가 우선합니다 — 표준 붙여넣기 동작입니다.

이미지 드래그해 넣기

Finder(macOS)나 파일 탐색기(Windows/Linux)에서 편집기로 이미지를 직접 드래그할 수도 있습니다. MarkNode는 해당 파일을 프로젝트의 미디어 폴더로 복사하고 드롭한 위치에 상대 경로 마크다운 링크를 삽입합니다.

프로젝트 트리에서 이미지 열기

파일 탐색기에서 이미지 파일을 더블 클릭하면 편집기 영역에 임베드된 이미지 뷰로 열립니다 — 작성 중인 문서가 참조하는 스크린샷을 앱을 벗어나지 않고 확인하고 싶을 때 편리합니다.

이미지 문법

인라인 이미지는 앞에 !를 붙인 표준 마크다운 문법을 사용합니다:

![Alt text](media/diagram.png)

너비를 조절해야 할 때는 인라인 HTML을 사용할 수도 있습니다:

<img src="media/diagram.png" alt="Diagram" width="400">

두 형식 모두 마우스 올리기, 수정자 키 클릭, 우클릭 메뉴가 동작합니다.