인라인 팝업

VMark는 링크, 이미지, 미디어, 수식, 각주 등을 편집하기 위한 컨텍스트 팝업을 제공합니다. 이 팝업들은 WYSIWYG 모드와 소스 모드 모두에서 일관된 키보드 탐색으로 작동합니다.

공통 키보드 단축키

모든 팝업은 다음 키보드 동작을 공유합니다:

동작	단축키
닫기/취소	Escape
확인/저장	Enter
필드 이동	Tab / Shift + Tab

링크 툴팁 및 팝업

VMark는 링크에 2단계 시스템을 사용합니다: 호버 시 읽기 전용 툴팁과 키보드 단축키를 통한 편집 팝업.

호버 툴팁 (읽기 전용)

트리거: 링크 위에 마우스 올리기 (300ms 지연)

표시 내용:

• URL 미리보기 — 잘린 URL, 호버 시 전체 URL 표시
• 열기 버튼 — 브라우저에서 링크 열기 (또는 #북마크의 경우 제목으로 이동)

동작: 보기 전용. 마우스를 이동하면 닫힘.

기존 링크 편집

트리거: 링크 안에 커서 위치 + Mod + K

필드:

• URL — 링크 대상 편집
• 열기 — 브라우저에서 링크 열기
• 복사 — URL을 클립보드에 복사
• 삭제 — 링크 제거, 텍스트 유지

새 링크 만들기

트리거: 텍스트 선택 + Mod + K

스마트 클립보드: 클립보드에 URL이 있으면 자동으로 채워집니다.

필드:

• URL 입력 — 대상 입력
• 확인 — Enter 누르거나 ✓ 클릭
• 취소 — Escape 누르거나 ✗ 클릭

소스 모드

• Cmd + Click 링크 위 → 브라우저에서 열기
• Click [text](url) 구문 위 → 편집 팝업 표시
• Mod + K 링크 안 → 편집 팝업 표시

북마크 링크

#으로 시작하는 링크는 북마크 (내부 제목 링크)로 처리됩니다. 열기는 브라우저를 열지 않고 제목으로 이동합니다.

미디어 팝업 (이미지, 비디오, 오디오)

모든 미디어 유형 — 이미지, 비디오, 오디오 — 편집을 위한 통합 팝업.

편집 팝업

트리거: 미디어 요소 더블클릭 (이미지, 비디오, 또는 오디오)

공통 필드 (모든 미디어 유형):

• 소스 — 파일 경로 또는 URL

유형별 필드:

필드	이미지	비디오	오디오
대체 텍스트	예	—	—
제목	—	예	예
포스터	—	예	—
치수	읽기 전용	—	—
인라인/블록 토글	예	—	—

버튼:

• 찾아보기 — 파일 시스템에서 파일 선택
• 복사 — 소스 경로를 클립보드에 복사
• 삭제 — 미디어 요소 제거

단축키:

• Mod + Shift + I — 새 이미지 삽입
• Enter — 변경 사항 저장
• Escape — 팝업 닫기

소스 모드

소스 모드에서 ![alt](path) 이미지 구문을 클릭하면 동일한 미디어 팝업이 열립니다. 미디어 파일 (비디오/오디오 확장자)은 호버 시 기본 재생 컨트롤이 있는 플로팅 미리보기를 표시합니다.

이미지 컨텍스트 메뉴

WYSIWYG 모드에서 이미지를 오른쪽 클릭하면 빠른 작업이 포함된 컨텍스트 메뉴가 열립니다 (더블클릭 편집 팝업과 별도).

트리거: 이미지에서 오른쪽 클릭

동작:

동작	설명
이미지 변경	이미지를 교체할 파일 선택기 열기
이미지 삭제	문서에서 이미지 제거
경로 복사	이미지 소스 경로를 클립보드에 복사
Finder에서 표시	파일 관리자에서 이미지 파일 위치 열기 (플랫폼에 따라 레이블 변경)

Escape를 눌러 작업 없이 컨텍스트 메뉴를 닫습니다.

수식 팝업

실시간 미리보기로 LaTeX 수식 표현식을 편집합니다.

트리거:

• WYSIWYG: 인라인 수식 $...$ 클릭
• 소스: $...$, $$...$$, 또는 ```latex 블록 내에 커서 위치

필드:

• LaTeX 입력 — 수식 표현식 편집
• 미리보기 — 실시간 렌더링 미리보기
• 오류 표시 — 도움이 되는 구문 힌트와 함께 LaTeX 오류 표시

단축키:

• Mod + Enter — 저장 및 닫기
• Escape — 취소 및 닫기
• Shift + Backspace — 인라인 수식 삭제 (비어 있지 않을 때도 작동, WYSIWYG 전용)
• Alt + Mod + M — 새 인라인 수식 삽입

오류 힌트

LaTeX 구문 오류가 있으면 팝업이 누락된 중괄호, 알 수 없는 명령, 불균형 구분자 등 도움이 되는 제안을 표시합니다.

소스 모드

소스 모드에서도 WYSIWYG 모드와 동일한 편집 가능한 수식 팝업을 제공합니다——LaTeX 입력을 위한 텍스트 영역과 아래에 실시간 KaTeX 미리보기가 표시됩니다. 커서가 수식 구문 ($...$, $$...$$, 또는 ```latex) 안에 들어가면 팝업이 자동으로 열립니다. Mod + Enter로 저장하거나 Escape로 취소합니다.

각주 팝업

각주 내용을 인라인으로 편집합니다.

트리거:

• WYSIWYG: 각주 참조 [^1] 위에 마우스 올리기

필드:

• 내용 — 여러 줄 각주 텍스트 (자동 크기 조정)
• 정의로 이동 — 각주 정의로 이동
• 삭제 — 각주 제거

동작:

• 새 각주는 내용 필드에 자동 포커스
• 입력하면 텍스트 영역이 확장됨

위키 링크 팝업

내부 문서 연결을 위한 위키 스타일 링크를 편집합니다.

트리거:

• WYSIWYG: [[target]] 위에 마우스 올리기 (300ms 지연)
• 소스: 위키 링크 구문 클릭

필드:

• 대상 — 워크스페이스 상대 경로 (.md 확장자 자동 처리)
• 찾아보기 — 워크스페이스에서 파일 선택
• 열기 — 연결된 문서 열기
• 복사 — 대상 경로 복사
• 삭제 — 위키 링크 제거

표 컨텍스트 메뉴

빠른 표 편집 동작.

트리거:

• WYSIWYG: 툴바 또는 키보드 단축키 사용
• 소스: 표 셀에서 오른쪽 클릭

동작:

동작	설명
위/아래에 행 삽입	커서 위치에 행 추가
왼쪽/오른쪽에 열 삽입	커서 위치에 열 추가
행 삭제	현재 행 제거
열 삭제	현재 열 제거
표 삭제	전체 표 제거
열 왼쪽/가운데/오른쪽 정렬	현재 열의 정렬 설정
모두 왼쪽/가운데/오른쪽 정렬	모든 열의 정렬 설정
표 서식	표 열 자동 정렬 (마크다운 미화)

맞춤법 검사 팝업

제안 사항으로 맞춤법 오류를 수정합니다.

트리거:

• 잘못 쓴 단어 (빨간 밑줄) 오른쪽 클릭

동작:

• 제안 사항 — 클릭하여 제안으로 대체
• 사전에 추가 — 더 이상 잘못 쓴 것으로 표시하지 않음

모드 비교

요소	WYSIWYG 편집	소스
링크	호버 툴팁 / Mod+K	클릭 / Mod+K / Cmd+Click으로 열기
이미지	더블클릭	 클릭
비디오	더블클릭	—
오디오	더블클릭	—
수식	클릭	커서가 수식 내 → 팝업
각주	호버	직접 편집
위키 링크	호버	클릭
표	툴바	오른쪽 클릭 메뉴
맞춤법 검사	오른쪽 클릭	오른쪽 클릭

팝업 탐색 팁

포커스 흐름

1. 팝업이 첫 번째 입력에 포커스를 맞추고 열립니다
2. Tab이 필드와 버튼을 앞으로 이동합니다
3. Shift + Tab이 뒤로 이동합니다
4. 포커스가 팝업 안에서 순환합니다

빠른 편집

• 간단한 URL 변경의 경우: 편집 후 Enter 누르기
• 취소의 경우: 어떤 필드에서든 Escape 누르기
• 여러 줄 내용 (각주, 수식)의 경우: 저장하려면 Mod + Enter 사용

마우스 동작

• 팝업 외부 클릭으로 닫기 (변경 사항이 취소됨)
• 호버 팝업 (링크, 각주, 위키)은 표시 전 300ms 지연이 있습니다
• 마우스를 팝업으로 돌아가면 열린 상태 유지