Troubleshooting

I cannot find the right-click command

Select text first and check that the active file is Markdown or plain text. You can always use Ctrl+Shift+P and search for Markdown AI in the Command Palette.

I declined the download

Use Markdown AI: Show Local Model Status and choose retry when available. Or select Use custom endpoint and configure markdownAi.useManagedEngine as described in Settings.

The download or integrity check fails

Check your internet connection and free disk space, then use Markdown AI: Show Local Model Status to retry. The managed model and runtime URLs are pinned and checksum-verified, so do not replace their files manually.

The local model does not start

Wait for the startup notification: the extension allows up to 90 seconds. Close other memory-intensive programs, confirm you have at least 4 GB of RAM available, then retry. If the problem continues, open View: Output in VS Code and select the extension’s output where available before reporting the error.

My custom endpoint fails

Confirm the endpoint is running, the base URL is reachable from VS Code, and it supports OpenAI-compatible POST /chat/completions requests. Make sure the configured model name exists on that endpoint.

The output is not what I expected

The model can make mistakes and does not verify facts. Undo with Ctrl+Z, then retry with a smaller selection or edit the result manually. Do not use generated output as the sole review for sensitive, legal, medical, or factual content.