Obsidian용 한국어 맞춤법 검사기

이 플러그인은 Obsidian에서 한국어 맞춤법과 문법을 검사하고 수정할 수 있는 기능을 제공합니다. 에디터에서 선택한 텍스트의 오류를 찾아 수정 제안을 제시하며, 직관적인 UI를 통해 손쉽게 교정할 수 있습니다.

이 플러그인은 부산대학교 인공지능연구실과 (주)나라인포테크가 공동 개발한 한국어 맞춤법 검사기의 API를 사용하여 정확하고 신뢰도 높은 검사 결과를 제공합니다.

---

주요 기능

• 선택 영역 맞춤법 검사: 에디터에서 선택한 텍스트의 맞춤법, 띄어쓰기, 문법 오류를 감지하고 수정안을 제안합니다.

• 인터랙티브 수정 인터페이스: 원문과 교정 제안을 한눈에 비교할 수 있는 모달(Modal) 창을 제공하며, 각 오류를 확인하며 쉽게 교정할 수 있습니다.

• 고유명사 사전: 사용자가 직접 추가한 단어(인명, 지명, 브랜드, 전문 용어 등)는 맞춤법 검사에서 제외하여 불필요한 오류 표시를 방지합니다.

• 페이지 분할 지원: 긴 글도 안정적으로 검사할 수 있도록 내부적으로 텍스트를 분할하여 처리합니다. 검사 결과가 많을 경우, 페이지를 나누어 보여줍니다.

• 테마 자동 감지: Obsidian의 라이트/다크 모드 테마에 맞춰 UI 스타일이 자동으로 변경됩니다.

---

설치 방법

1. 플러그인 다운로드

   • 이 저장소의 [Releases]페이지에서 최신 버전의 main.js, styles.css, manifest.json 파일을 다운로드합니다.

2. Obsidian 플러그인 폴더에 새 폴더 생성

   • Obsidian Vault의 플러그인 폴더(일반적으로 /.obsidian/plugins/)로 이동합니다.

   • korean-spellchecker 와 같은 이름으로 새 폴더를 만듭니다.

3. 파일 복사

   • 다운로드한 main.js, styles.css, manifest.json 세 개의 파일을 방금 만든 폴더 안에 넣습니다.

4. 플러그인 활성화

   • Obsidian을 재시작하거나, 플러그인 목록을 새로고침합니다.

   • 설정(Settings) → 커뮤니티 플러그인(Community Plugins)에서 'Korean Spellchecker'를 찾아 활성화(enable)합니다.

---

사용 방법

1. 맞춤법 검사 실행

   • 에디터에서 검사하고 싶은 텍스트를 마우스로 드래그하여 선택합니다.

   • 왼쪽 리본(Ribbon) 메뉴의 가 아이콘을 클릭하거나, 커맨드 팔레트(Ctrl/Cmd + P)를 열고 Check spelling 명령을 실행합니다.

2. 검사 결과 확인 및 수정

   • 맞춤법 검사 결과가 담긴 모달 창이 나타납니다.

   • 상단에는 원본 텍스트와 수정 미리보기가 나란히 표시됩니다.

   • 아래에는 각 오류 항목과 수정 제안(라디오 버튼)이 나열됩니다.

   • 제시된 수정안을 선택하거나, 직접 수정 옵션을 선택하고 원하는 내용을 입력할 수 있습니다.

   • 수정 사항은 우측 미리보기에 즉시 반영됩니다.

3. 교정 내용 적용

   • 모든 오류를 검토한 후, 모달 창 하단의 적용 버튼을 클릭하면 에디터의 원본 텍스트가 교정된 내용으로 완전히 대체됩니다.

   • 결과가 여러 페이지일 경우, 이전/다음 버튼으로 페이지를 이동하며 검토할 수 있습니다.

---

주요 기능 상세 설명

1. 인터랙티브 수정 창

단순히 오류만 알려주는 것을 넘어, 사용자가 쉽고 편하게 교정할 수 있도록 설계되었습니다.

• 좌측(원본): 현재 페이지에서 검출된 오류 단어들이 하이라이트됩니다.

• 우측(미리보기): 사용자가 선택한 수정안이 실시간으로 반영되어 최종 결과를 예측할 수 있습니다.

• 수정 옵션: 각 오류마다 제안 단어 선택, 원본 유지, 직접 수정 옵션을 제공하여 유연한 교정이 가능합니다.

2. 고유명사 사전 (Custom Noun Dictionary)

소설이나 시나리오, 기술 문서를 작성하다 보면 작가가 직접 만든 이름이나 전문 용어가 자주 등장합니다. 이런 단어들은 사전에 없기 때문에 맞춤법 검사기에서 '오류'로 취급됩니다. 고유명사 사전은 이러한 단어들을 미리 등록하여, 검사 결과에서 불필요한 교정 제안이 뜨지 않도록 하는 강력한 기능입니다.

상황	예시 문장	검사 결과
등록 전	아르키메데스는 솔라리온 기술을 연구했다.	"솔라리온 → 솔라리스" 와 같이 의도치 않은 수정안 제시
등록 후	(동일 문장)	오류 없음 — '솔라리온'이 고유명사로 인식되어 검사에서 제외됨

고유명사 관리 방법

• 커맨드 팔레트(Ctrl/Cmd + P)에서 Manage custom nouns를 검색하여 실행합니다.

• 모달 창이 열리면, 새 고유명사를 입력하고 "추가" 버튼을 눌러 등록합니다.

• 이미 등록된 고유명사는 리스트에서 "삭제" 버튼으로 언제든지 제거할 수 있습니다.

TIP: 자주 사용하는 캐릭터 이름, 지명, 기술명 등을 한 번만 등록해두면, 긴 원고도 스트레스 없이 교정할 수 있습니다.

---

서비스 제공

이 플러그인은 부산대학교 인공지능연구실과 (주)나라인포테크가 개발한 한국어 맞춤법/문법 검사기의 API를 사용합니다.

해당 서비스의 정책에 따라, 이 검사기는 개인 및 학생 사용자의 비상업적 목적에 한해 무료로 제공됩니다. 상업적 목적으로 사용해야 할 경우, 해당 기관에 직접 문의하시기 바랍니다.

훌륭한 서비스를 연구하고 제공해주시는 개발팀에 감사드립니다.

---

기여하기

이 프로젝트는 오픈 소스이며, 여러분의 기여를 언제나 환영합니다. 버그 리포트, 기능 제안, 코드 개선 등 어떤 형태의 기여든 좋습니다. GitHub 저장소의 Issues 탭에 의견을 남겨주세요.

라이선스

이 플러그인은 MIT 라이선스 하에 배포됩니다.