A Markdown linter helps to unify the markup style of the content. The following short configuration changes a few rules of Markdownlint.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# Line length should not be limited, because we use soft wrapping
MD013: false  
# Empty lines above and below headings
MD022:
  lines_above: 1
  lines_below: 0
# Duplicate headings
MD024: 
  siblings_only: true
  allow_different_nesting: true
# Ordered list
MD029: 
  style: "ordered"
# No inline HTML. But because inline HTML is already skipped and removed
# with our Hugo configuration, the rule is not necessary. 
# And it would also be triggered by angled brackets intended for the typographer.
MD033: false 
# Emphasis style
MD049:
  style: "underscore"
# Strong style
MD050:
  style: "asterisk"  

There are also configuration files for Markdownlint in some content folders. They allow to document some variations of Markdown.