##
## Règles communes pour la rédaction des sources Markdown
##
## Pour chaque règle désactivée ou configurée, mettre un commentaire
## explicatif
##
## Listes des règles:
## https://github.com/markdownlint/markdownlint/blob/main/docs/RULES.md
##

# Par défaut, toutes les règles sont activées
all

# Les titres doivent être cohérents dans tout le document
rule 'MD003', :style => :consistent

# On se donne un peu de liberté pour les titres
exclude_rule 'MD002'

# On se donne un peu de liberté pour les listes
exclude_rule 'MD004'

# On autorise les lignes vides consécutives
exclude_rule 'MD012'

# On autorise les ligne de plus de 80 caractères dans les blocs de code
rule "MD013", :ignore_code_blocks => true

# Plus de flexibilité dans les blocs de code bash et console
exclude_rule 'MD014'

# On utiliser plusieurs fois le même titre, à différents niveaux
rule "MD024", :allow_different_nesting => true

# On autorise plusieurs titres de niveau 1 et 2
rule 'MD025', :level => 3

# On autorise la ponctuation à la fin d'un titre
exclude_rule 'MD026'

# L'incrémentation des listes est libre
exclude_rule 'MD029'

# On autorise les balises HTML
exclude_rule 'MD033'
# NB: On pourrait être plus sélectif :
#rule 'MD033', :allowed_elements => 'br, p, div'

# On autorise les URL "nues"
exclude_rule 'MD034'

# Plus de souplesse sur l'emphase dans les slides

exclude_rule 'MD036'

# On autorise les blocs de code sans langage
exclude_rule 'MD040'

# On autorise du texte avant le titre initial
exclude_rule 'MD041'

# Les blocs de code doivent être cohérents dans tout le document
rule 'MD046', :style => :consistent