인라인 팝업

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) 이미지 구문을 클릭하면 동일한 미디어 팝업이 열립니다. 미디어 파일 (비디오/오디오 확장자)은 호버 시 기본 재생 컨트롤이 있는 플로팅 미리보기를 표시합니다.

수식 팝업

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

트리거:

• WYSIWYG: 인라인 수식 $...$ 클릭

필드:

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

단축키:

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

오류 힌트

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

소스 모드

소스 모드에서는 텍스트에서 직접 수식을 편집합니다. 미리보기는 Mermaid/수식 미리보기 패널에 나타납니다.

각주 팝업

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

트리거:

• 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 지연이 있습니다
• 마우스를 팝업으로 돌아가면 열린 상태 유지