Skip to content

Commit b1bc12e

Browse files
committed
Disable MD031 and MD025 linting rules
- MD031: Disable 'blanks around fences' rule to support Hugo choosable shortcodes - MD025: Disable 'multiple top level headings' rule for guideline files like CLAUDE.md These rules were incorrectly flagging valid Hugo shortcode syntax used throughout the docs. Hugo's {{% choosable %}} shortcodes are not actual fenced code blocks and should not have blank lines around them.
1 parent 8d7f3bc commit b1bc12e

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

scripts/lint/lint-markdown.js

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -299,6 +299,10 @@ const opts = {
299299
MD034: false,
300300
// Allow bold/italicized paragraphs
301301
MD036: false,
302+
// Allow code blocks without blank lines around them (Hugo shortcodes like choosable)
303+
MD031: false,
304+
// Allow multiple top level headings (for CLAUDE.md guideline files)
305+
MD025: false,
302306
},
303307
customRules: [
304308
{

0 commit comments

Comments
 (0)