pymarkdownlnt
A GitHub Flavored Markdown compliant Markdown linter.
Decision gist · record as of 2026-08-14
Yes. PyMarkdown is actively maintained, has low install friction, carries no known vulnerabilities, and offers structure-aware linting based on standardized specs—a meaningful step up from line-based pattern matching. Install it if you want automated Markdown quality checks in your project or CI pipeline.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Low install friction with a pure Python wheel distribution.
- The project is actively maintained with recent releases and shows consistent commit activity.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal restrictions.
last release 2026-07-12 (33 days) · last repo commit 2026-08-09 · 138 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,508,368 downloads/mo, #3,827 on PyPI
Alternatives
Verify before relying
pip install pymarkdownlnt
pymarkdown scan .- Whether custom rule plugins can be written by users or if rules are fixed to the built-in set.
- Performance characteristics when linting large Markdown document collections.
- Whether the linter integrates with common CI/CD platforms or pre-commit hooks beyond what the description mentions.
What it is and what it does
PyMarkdown is a command-line Markdown linter that parses documents according to GitHub Flavored Markdown and CommonMark specifications, then applies structure-aware rules to check for style and formatting issues. Unlike simple regex-based linters, it understands document structure—headings, lists, links, and other block elements—and makes rule decisions based on parsed tokens rather than raw text patterns.
The tool is built around a rule engine that loads and runs focused checks (like heading level validation or list indentation rules) and supports optional extensions for parsing variations. It runs on Windows, macOS, and Linux, requires Python 3.10 or later, and is designed to fit into existing workflows like static analysis pipelines, pre-commit hooks, or dependency management systems. Configuration is available for customizing which rules apply to your project.
Use it for
- Enforce consistent Markdown style in documentation repositories before commits or CI builds.
- Validate technical documentation against GFM and CommonMark standards in automated pipelines.
- Check Markdown files in a project directory for structural and formatting violations as part of code review.
- Integrate into pre-commit workflows to catch Markdown issues before they reach version control.
- Customize linting rules for project-specific Markdown guidelines without complex setup.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
PyMarkdown is actively maintained, has low install friction, carries no known vulnerabilities, and offers structure-aware linting based on standardized specs—a meaningful step up from line-based pattern matching. Install it if you want automated Markdown quality checks in your project or CI pipeline.
Install
pymarkdownlnt on PyPI
Before you install
Low install friction with a pure Python wheel distribution. The project is actively maintained with recent releases and shows consistent commit activity. Five runtime dependencies are all lightweight utilities.
Requires Python 3.10 or later.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal restrictions.
Quickstart
pip install pymarkdownlnt
pymarkdown scan .
Verify before relying
- Whether custom rule plugins can be written by users or if rules are fixed to the built-in set.
- Performance characteristics when linting large Markdown document collections.
- Whether the linter integrates with common CI/CD platforms or pre-commit hooks beyond what the description mentions.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagestyping-extensionsapplication-propertiesapplication-file-scannercolumnarpy-walk |
| Maintenance | Actively maintained 33 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,508,368 / month, #3,827 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Software Development :: Libraries :: Application Frameworks |
Evidence: pymarkdownlnt-0.9.39-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “markdown linter”
- pymarkdownlntPyMarkdown is a GitHub Flavored Markdown linter that analyzes…
- rumdlA Rust-based Markdown linter and formatter that checks files against…
- mdformatMdformat is a CommonMark-compliant command-line Markdown formatter…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also markdown-it-pyrs · tree-sitter-markdown · mdformat · rumdl · yamllint · multimark · j2lint · markdown-it-py · marko · PyTestArch