A project can have a green test suite while its README example is stale. The docs are often the first thing a new user runs, and one missing colon or moved setup link can waste the first few minutes.
I built snipverify to check syntax in fenced code blocks and local targets in relative links. It scans Markdown files from a directory or one file at a time. The first release checks JavaScript, TypeScript, Python, JSON, Bash, and POSIX shell examples.
What it checks
For each supported code fence, snipverify parses the contents and reports the file and source line when the syntax is invalid. It does not start the commands or scripts from the document. For local links and images, it checks whether the relative target exists on disk. It skips external URLs and fragment-only links.
Unlabeled fences and languages without a checker are reported as skipped. This makes an unsupported block visible without treating it as a syntax error. A JSON mode is available for CI, so a job can
Discussion
Don’t hold back—comment!
Don’t wait—start sharing your ideas now!