I built a VS Code extension that reads your code aloud and narrates git diffs with AI

I do a lot of doc-heavy and review-heavy work, and I kept losing time re-reading dense markdown and PRs instead of just listening to them. "Just use a screen reader" doesn't really work for code — it reads asterisks and pound signs literally instead of understanding markdown structure. So I built Markdown TTS, a VS Code extension that actually parses the content first, then speaks it.

What it does

Two distinct modes:

1. Literal reading — strips markdown syntax properly (headings become "Heading level 2: ...", tables read as CSV, code blocks skipped, links keep their text) and reads it aloud via your OS's built-in voice — SAPI on Windows, say on macOS. Fully offline, no API key, no account. There's also an optional Microsoft Edge neural voice mode if you want higher quality and don't mind the request leaving your machine.

2. AI narration (bring your own key) — instead of reading a file verbatim, an LLM explains what it does in plain English, then narrates that explanation. There's also a command that runs git diff locally and speaks an AI summary of your uncommitted changes or last commit, which I now use as a last check before committing instead of re-reading a wall of red and green text. Works with OpenAI, Anthropic, or Groq (free tier, no card needed). Only these two commands ever contact an API — literal reading stays completely offline.