gomarklint – command-line Markdown linter

gomarklint is a command-line Markdown linter written in Go for engineering teams that want to keep documentation quality under control.

It’s designed for local development and CI workflows, helping catch structural and content issues in Markdown files before broken docs, inconsistent headings, or other avoidable problems make their way into published documentation.

This is free and open source software.

Key Features

  • Supports configurable rules with opt-in or opt-out behavior and per-rule severity levels.
  • Checks for issues including unclosed fenced code blocks, empty image alt text, invalid heading progression, duplicate headings, multiple blank lines, and Setext headings.
  • Offers both text and JSON output for terminal use, automation, and CI tooling.
  • Provides fast structural checks, with optional external link validation for deeper verification.
  • Includes an official GitHub Action for integrating Markdown linting into GitHub Actions workflows.
  • Can be installed from prebuilt binaries, with go install, or by building from source.

Website: github.com/shinagawa-web/gomarklint
Support:
Developer: shinagawa-web
License: MIT License

gomarklint is written in Go. Learn Go with our recommended free books and free tutorials.


Best Free and Open Source Software Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.

This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk.

You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more.

Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form.
Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments