[272] 옵시디언 Spacekeys 플러그인 소개 글

Obsidian Spacekeys Plugin 사용법 가이드

Obsidian Spacekeys는 사용자가 단순한 키 입력 시퀀스를 통해 명령을 실행할 수 있도록 돕는 플러그인입니다. 이는 Emacs의 Spacemacs에서 영감을 받아 설계되었으며, 복잡한 단축키를 외우지 않아도 Obsidian의 대부분 기능에 빠르게 접근할 수 있게 해줍니다. 아래는 Spacekeys 플러그인의 설치 및 사용 방법을 단계별로 설명한 가이드입니다.

1. 주요 특징

• 기억하기 쉬움: 키는 간단한 연상법으로 할당됩니다.
• 학습 용이성: 리더 키를 누르면 사용 가능한 명령 메뉴가 표시됩니다.
• 명령 확장성: Obsidian 기본 명령뿐만 아니라 다른 플러그인 명령도 포함 가능하며, 사용자 정의 키맵을 지원합니다.

2. 설치 방법

Spacekeys는 아직 Obsidian 커뮤니티 플러그인 목록에 포함되지 않았으므로 수동 설치가 필요합니다.

1. GitHub에서 최신 릴리스의main.js,styles.css,manifest.json파일을 다운로드합니다.
2. Obsidian Vault 폴더 내.obsidian/plugins/obsidian-spacekeys/디렉토리를 생성하고 다운로드한 파일을 복사합니다.
3. Obsidian을 재시작한 후, 설정 메뉴에서Community Plugins → Installed Plugins → Spacekeys로 이동하여 플러그인을 활성화합니다.
   

3. 사용법

리더 키 설정

1. Obsidian 설정에서Hotkeys섹션으로 이동합니다.
2. 검색창에Spacekeys: Leader를 입력하여 리더 키 명령을 찾습니다.
3. 원하는 단축키(예:Ctrl + M)를 설정합니다.

명령 실행

1. 리더 키를 누릅니다(예:Ctrl + M).
2. 이어서 원하는 명령의 키 시퀀스를 입력합니다.
   • 예:i l→Insert → Link명령 실행
   • 예:f n n→File → New → Create new note

메뉴 탐색

• 리더 키를 누르면 팝업 메뉴가 나타나며, 사용할 수 있는 명령 또는 하위 그룹이 표시됩니다.
• 하위 그룹은 색상이나 강조 표시로 구분되며, 해당 키를 누르면 관련 명령이 표시됩니다.
• 메뉴에서 나가려면Esc키를 누릅니다.

4. 사용자 정의

키맵 파일 생성 및 편집

1. 설정 메뉴에서Community Plugins → Spacekeys로 이동합니다.
2. "Spacekeys keymap file" 섹션에서 YAML 파일 경로를 지정합니다(예:_config/spacekeys.yml).
3. "Create file with default contents" 버튼을 눌러 기본 키맵 파일을 생성합니다.
4. YAML 파일을 열어 다음 형식으로 키맵을 정의합니다:

items:

/:

command: global-search:open

description: Search in all files

f:

description: File

items:

d:

command: app:delete-file

description: Delete file

m:

command: file-explorer:move-file

5. 변경 사항 적용을 위해 "Reload keymap from file" 버튼을 클릭하거나Spacekeys: Reload keymap명령을 실행합니다.

유효 키와 특수 문자

• 모든 출력 가능한 문자와Tab,Space가 유효한 키로 사용 가능합니다.
• 대문자와 소문자는 구분됩니다(예:A≠a).
• YAML 문법과 충돌하는 문자는 따옴표로 감싸야 합니다(예:"?": Shift +/).

5. Vim 모드와의 통합

Vim 모드를 사용하는 경우,.vimrc파일에 다음 코드를 추가하여 특정 모드에서 Spacekeys 리더 키를 설정할 수 있습니다:

" Spacekeys leader

exmap spacekeysleader obcommand spacekeys:leader

nmap <Space> :spacekeysleader<CR>

vmap <Space> :spacekeysleader<CR>

6. 활용 사례

기본 명령 예시

커스텀 명령 추가

사용자는 Obsidian의 다른 플러그인 명령도 포함할 수 있습니다. 예를 들어, 특정 플러그인의 ID를 찾아 YAML 파일에 추가하면 됩니다.Spacekeys 플러그인은 단순하면서도 강력한 방식으로 Obsidian 워크플로우를 개선해줍니다. 특히 많은 단축키 조합을 기억하기 어려운 사용자에게 적합하며, 학습 곡선을 크게 줄여줍니다.