Korean Grammar Assistant is an Obsidian plugin for checking Korean spelling and grammar without leaving your vault. It supports the default grammar proxy, optional NaraSpeller/Bareun.ai providers, popup or inline review, and optional AI-assisted suggestions.

Install

Install it from the Obsidian Community Plugins store:

1. Open Obsidian Settings -> Community plugins.
2. Browse and search for Korean Grammar Assistant.
3. Install and enable the plugin.

Manual installation is only needed for development or testing. Download main.js, manifest.json, and styles.css from a GitHub release and place them in:

<your vault>/.obsidian/plugins/korean-grammar-assistant/

Features

• Korean spelling and grammar checking from selected editor text.
• Popup review mode for focused correction sessions.
• Inline review mode for checking suggestions directly in the editor.
• Correction states for applying a suggestion, keeping the original, ignoring a term, or editing manually.
• Optional AI review with OpenAI, Anthropic Claude, Google Gemini, or local Ollama.
• Keyboard-friendly review flow for moving between detected issues and applying corrections.

Grammar Providers

The default grammar check uses the app proxy at appstore.junlim.org, so no Bareun.ai API key is required for the default setup.

You can also configure:

• 부산대 맞춤법 검사기 / NaraSpeller: requires a NaraSpeller API key.
• Direct Bareun.ai API/server: requires a Bareun.ai account, API key, and direct API host settings. This is separate from the NaraSpeller/Barun Hangeul service.

Bareun.ai API Key

Bareun.ai and NaraSpeller have similar Korean names, but they are different services from different providers.

To get a Bareun.ai API key:

1. Open the Bareun.ai spelling checker page.
2. Sign up or log in to Bareun.ai.
3. Complete email verification if required.
4. Check the API key from Login -> My Info (로그인 -> 내정보). The official Bareun.ai quick-start guide describes this as the place where the key is shown after signup and email verification.
5. In Obsidian Settings -> Korean Grammar Assistant -> API Connection (API 연결), enter it in Bareun.ai API 키 only when using a direct Bareun.ai API server. The default proxy does not require this key.

NaraSpeller API Key

To use the NaraSpeller provider:

1. Open the official Barun Hangeul/NaraInfoTech order page.
2. Check the Online API section.
3. Contact the purchase inquiry channel listed on that page to request API access.
4. After receiving a key, open Obsidian Settings -> Korean Grammar Assistant -> API Connection (API 연결).
5. Set Grammar Provider (검사 엔진) to NaraSpeller (부산대 맞춤법 검사기) and enter the key in 부산대 API 키.

Basic Usage

1. Select Korean text in the editor.
2. Run Korean Grammar Assistant from the ribbon icon or command palette.
3. Review detected issues in the popup or inline editor.
4. Apply a suggestion, keep the original text, ignore a term, or edit manually.
5. Apply the final changes back to the note.

Privacy

The plugin sends only the selected text to the grammar provider you configure. If NaraSpeller is selected, the NaraSpeller API key is sent with the request through the app proxy. If AI review is enabled, correction context is sent to the AI provider selected in settings.

API keys are stored locally in your Obsidian configuration. The plugin does not include telemetry, analytics, tracking, or a remote plugin account system.

한국어 맞춤법 검사기

Obsidian 안에서 한국어 맞춤법과 문법을 검사하는 플러그인입니다. 기본 프록시, 부산대 맞춤법 검사기(NaraSpeller), 직접 Bareun.ai 서버를 선택할 수 있고, 팝업/인라인 검토와 선택적 AI 분석을 지원합니다.

설치

이제 BRAT이 아니라 Obsidian 커뮤니티 플러그인 스토어에서 설치하면 됩니다.

1. Obsidian 설정 -> 커뮤니티 플러그인을 엽니다.
2. 탐색에서 Korean Grammar Assistant를 검색합니다.
3. 설치 후 플러그인을 활성화합니다.

수동 설치는 개발 또는 테스트용입니다. GitHub 릴리스에서 main.js, manifest.json, styles.css를 받아 다음 폴더에 넣습니다.

<내 볼트>/.obsidian/plugins/korean-grammar-assistant/

주요 기능

• 선택한 한국어 텍스트의 맞춤법과 문법 검사.
• 팝업 모드와 인라인 모드 지원.
• 수정 적용, 원본 유지, 예외 처리, 직접 편집 흐름.
• OpenAI, Anthropic Claude, Google Gemini, Ollama 기반 선택적 AI 검토.
• 키보드 중심 검토와 수정 제안 이동.

검사 엔진

기본값은 appstore.junlim.org 프록시를 사용하므로 별도 Bareun.ai API 키가 필요하지 않습니다.

추가로 설정할 수 있는 엔진:

• 부산대 맞춤법 검사기: 부산대/NaraSpeller API 키 필요.
• 직접 Bareun.ai 서버: Bareun.ai 계정, API 키, 직접 API 호스트 설정 필요. 부산대/NaraSpeller 키와는 별개입니다.

Bareun.ai API 키 받기

Bareun.ai와 부산대 맞춤법 검사기(NaraSpeller/바른한글)는 이름이 비슷하지만 서로 다른 서비스입니다.

1. Bareun.ai 맞춤법 검사기 페이지를 엽니다.
2. Bareun.ai에 가입하거나 로그인합니다.
3. 필요한 경우 이메일 인증을 완료합니다.
4. Bareun.ai 공식 훑어보기 안내처럼 로그인 -> 내정보에서 API 키를 확인합니다.
5. 직접 Bareun.ai API 서버를 사용할 때만 Obsidian 설정 -> Korean Grammar Assistant -> API 연결의 Bareun.ai API 키에 입력합니다. 기본 프록시를 사용할 때는 비워둘 수 있습니다.

부산대 맞춤법 검사기 API 키 받기

1. 바른한글/나라인포테크 구매 안내 페이지를 엽니다.
2. 온라인 API 섹션의 시범 서비스 안내를 확인합니다.
3. 페이지 하단 구매 문의에 안내된 연락처로 온라인 API 이용과 키 발급을 문의합니다.
4. API 키를 받으면 Obsidian 설정 -> Korean Grammar Assistant -> API 연결로 이동합니다.
5. 검사 엔진을 부산대 맞춤법 검사기로 선택하고 부산대 API 키에 입력합니다.

사용법

1. 검사할 한국어 텍스트를 선택합니다.
2. 리본 아이콘 또는 명령 팔레트에서 Korean Grammar Assistant를 실행합니다.
3. 팝업 또는 인라인 화면에서 오류와 제안을 검토합니다.
4. 수정 적용, 원본 유지, 예외 처리, 직접 편집 중 하나를 선택합니다.
5. 최종 변경 사항을 문서에 적용합니다.

개인정보

플러그인은 선택한 텍스트만 설정된 검사 엔진으로 전송합니다. 부산대 맞춤법 검사기를 선택하면 검사 요청 처리를 위해 부산대 API 키가 앱 서버 프록시로 함께 전송됩니다. AI 검토를 실행하면 오류 문맥이 사용자가 선택한 AI 제공자로 전송됩니다.

API 키는 Obsidian 설정에 로컬로 저장됩니다. 플러그인은 텔레메트리, 분석 추적, 원격 계정 시스템을 포함하지 않습니다.