markdownlint rule mapping
June 21, 2026 · View on GitHub
Each row pairs an mdsmith rule with the markdownlint rule or
rules it covers, ordered by mdsmith rule id. (partial)
marks a mapping that covers only part of the markdownlint
check. A markdownlint name follows its id when the two
differ.
The table is generated from the markdownlint: front matter
in each rule README. mdsmith init --from-markdownlint
reads the same data, so the table and the converter cannot
drift apart. mdsmith fix regenerates the table.
| markdownlint | mdsmith |
|---|---|
| MD013 line-length | MDS001 line-length |
| MD003 heading-style | MDS002 heading-style |
| MD001 heading-increment | MDS003 heading-increment |
| MD041 first-line-h1 | MDS004 first-line-heading |
| MD024 no-duplicate-heading | MDS005 no-duplicate-headings |
| MD009 no-trailing-spaces | MDS006 no-trailing-spaces |
| MD010 no-hard-tabs | MDS007 no-hard-tabs |
| MD012 no-multiple-blanks | MDS008 no-multiple-blanks |
| MD047 single-trailing-newline | MDS009 single-trailing-newline |
| MD048 code-fence-style | MDS010 fenced-code-style |
| MD040 fenced-code-language | MDS011 fenced-code-language |
| MD034 no-bare-urls | MDS012 no-bare-urls |
| MD022 blanks-around-headings | MDS013 blank-line-around-headings |
| MD032 blanks-around-lists | MDS014 blank-line-around-lists |
| MD031 blanks-around-fences | MDS015 blank-line-around-fenced-code |
| MD005 list-indent (partial), MD007 ul-indent | MDS016 list-indent |
| MD026 no-trailing-punctuation | MDS017 no-trailing-punctuation-in-heading |
| MD036 no-emphasis-as-heading | MDS018 no-emphasis-as-heading |
| MD043 required-headings | MDS020 required-structure |
| MD055 table-pipe-style, MD056 table-column-count (partial), MD058 blanks-around-tables | MDS025 table-format |
| MD051 link-fragments (partial) | MDS027 cross-file-reference-integrity |
| MD045 no-alt-text | MDS032 no-empty-alt-text |
| MD033 no-inline-html | MDS041 no-inline-html |
| MD049 emphasis-style, MD050 strong-style | MDS042 emphasis-style |
| MD035 hr-style | MDS044 horizontal-rule-style |
| MD004 ul-style | MDS045 list-marker-style |
| MD029 ol-prefix | MDS046 ordered-list-numbering |
| MD037 no-space-in-emphasis | MDS047 ambiguous-emphasis |
| MD039 no-space-in-links | MDS049 no-space-in-link-text |
| MD044 proper-names | MDS050 proper-names |
| MD025 single-h1 | MDS051 single-h1 |
| MD038 no-space-in-code | MDS052 no-space-in-code-spans |
| MD053 link-image-reference-definitions | MDS053 no-unused-link-definitions |
| MD052 reference-links-images | MDS054 no-undefined-reference-labels |
| MD027 no-multiple-space-blockquote, MD028 no-blanks-blockquote | MDS059 blockquote-whitespace |
| MD030 list-marker-space | MDS061 list-marker-space |
| MD011 no-reversed-links, MD042 no-empty-links | MDS062 link-validity |
| MD059 descriptive-link-text | MDS063 descriptive-link-text |
| MD018 no-missing-space-atx, MD019 no-multiple-space-atx, MD020 no-missing-space-closed-atx (partial), MD021 no-multiple-space-closed-atx, MD023 heading-start-left | MDS064 atx-heading-whitespace |
| MD046 code-block-style | MDS065 code-block-style |
| MD014 commands-show-output | MDS066 commands-show-output |
| MD054 link-image-style | MDS068 link-style |
| MD051 link-fragments | MDS070 same-file-anchor |
See also
mdsmith init—--from-markdownlintconverts a config through this mapping.- Migrate from markdownlint — the migration workflow.
- Markdown linters comparison — feature-level comparison across peer linters.