Markdown Wise
AI-powered grammar, spelling, and punctuation checker for Markdown files in VS Code.
Markdown Wise sends your text to an AI provider of your choice and surfaces issues as inline squiggles with hover explanations and one-click quick-fixes — just like a spell-checker, but smarter.
Features
- Inline diagnostics — grammar, spelling, and symbol errors appear as squiggles directly in the editor.
- Hover details — hover over any squiggle to see the suggested fix and a short explanation.
- Quick-fix actions — press
Ctrl+. / Cmd+. on an issue to apply the suggestion instantly.
- Fix All Issues — apply every suggestion in the document in one command.
- Check Selection — run a check on just the selected text, not the whole file.
- On-save checking — optionally check automatically every time you save.
- Large-file mode — for files over the configured character threshold the corrected document is shown in a diff view instead of per-issue squiggles.
- Multiple AI providers — OpenAI, Google Gemini, Anthropic Claude, or any OpenAI-compatible endpoint (Ollama, OpenRouter, LM Studio, etc.).
- Custom prompt — override the built-in system prompt with your own, using the
${LANG} variable for the configured dialect.
Requirements
An API key for at least one of the supported providers:
Getting Started
- Install the extension.
- Open the Command Palette (
Ctrl+Shift+P / Cmd+Shift+P) and run Markdown Wise: Set API Key.
- Select your provider and paste your API key. It is stored securely in VS Code's secret storage — never in
settings.json.
- Open any Markdown file and save it, or run Markdown Wise: Check Document from the Command Palette.
Commands
| Command |
Shortcut |
Description |
| Markdown Wise: Check Document |
Ctrl+Shift+Alt+G |
Check the entire active document |
| Markdown Wise: Check Selection |
Ctrl+Shift+Alt+S |
Check only the selected text |
| Markdown Wise: Fix All Issues |
Ctrl+Shift+Alt+F |
Apply all suggested fixes at once |
| Markdown Wise: Set API Key |
— |
Store an API key for the selected provider |
The commands are also accessible from the editor title bar icons (when a Markdown file is open) and via right-click context menu.
Settings
| Setting |
Default |
Description |
markdownWise.provider |
gemini |
AI provider: openai, gemini, claude, or custom |
markdownWise.model |
(provider default) |
Model name. Leave empty to use the provider's default (see below) |
markdownWise.apiUrl |
(empty) |
Base URL for the custom provider (e.g. http://localhost:11434/v1) |
markdownWise.language |
American English |
Dialect passed to the AI: American / British / Australian / Canadian English |
markdownWise.files.include |
["**/*.md","**/*.txt","**/*.mdx"] |
Glob patterns for files to check |
markdownWise.files.exclude |
["**/node_modules/**",…] |
Glob patterns for files to skip |
markdownWise.prompt |
(built-in) |
Custom system prompt. Supports ${LANG}. Leave empty to use the default |
markdownWise.largeFileThreshold |
5000 |
Character count above which full-document diff mode is used |
markdownWise.checkOnSave |
true |
Run a check automatically on save |
Default models
| Provider |
Default model |
| OpenAI |
gpt-4o-mini |
| Gemini |
gemini-2.5-flash |
| Claude |
claude-3-haiku-20240307 |
| Custom |
(must be specified) |
Using a Custom / Local Provider
Set markdownWise.provider to custom and point markdownWise.apiUrl at any OpenAI-compatible server:
"markdownWise.provider": "custom",
"markdownWise.apiUrl": "http://localhost:11434/v1",
"markdownWise.model": "llama3"
For local models that require no authentication, run Set API Key and enter any placeholder value (e.g. none).
How It Works
- Small files (below
largeFileThreshold characters): the AI returns a structured list of issues. Each issue becomes a diagnostic squiggle with a quick-fix code action.
- Large files: the AI returns the fully corrected document. The result is shown in VS Code's diff editor so you can review and accept changes.
- Text positions are found by substring search — no line/column numbers are requested from the AI, which makes location reliable regardless of model.
- API keys are stored in VS Code's built-in
SecretStorage API and are never written to disk in plain text.
AI Work
All the project development process done using Claude AI.
License
MIT — see LICENSE.
