0.1.0 • Published 9 months ago

@silvermine/markdownlint-rule-indent-alignment v0.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

markdownlint-rule-indent-alignment

NPM Version License Conventional Commits

What?

This is a custom markdownlint rule to lint the alignment of list items and blocks (e.g. code blocks). For example:

Invalid :no_entry:Valid :white_check_mark:
Lorem ipsum dolor sit amet consectetur adipiscing elit.Lorem ipsum dolor sit ametconsectetur adipiscing elit.
* Lorem ipsum * Dolor sit amet Lorem ipsum Dolor sit amet
1. Lorem ipsum * Dolor sit amet1. Lorem ipsum * Dolor sit amet
* Lorem ipsum dolor sit ametconsectetur adipiscing elit* Lorem ipsum dolor sit amet consectetur adipiscing elit
1. Lorem ipsum dolor sit amet consectetur adipiscing elit1. Lorem ipsum dolor sit amet consectetur adipiscing elit
* Lorem: ```text hello world ```* Lorem: ```text hello world ```
> Lorem ipsum dolor sit amet > consectetur adipiscing elit> Lorem ipsum dolor sit amet> consectetur adipiscing elit

Usage

To use this custom markdownlint rule two things needed:

  1. Update your markdownlint config to include "indent-alignment": true
  2. Add this rule to the list of custom markdownlint rules. If using markdownlint-cli, this would look something like:

    markdownlint -r './node_modules/@silvermine/markdownlint-rule-indent-alignment/src/indent-alignment.js' -c .markdownlint.json README.md

Rule configuration

This rule has the following config options:

  • ul_indent: Desired indention of ul lists (number, default undefined)

    • By default, child ul items will be aligned with the content. When ul_indent is set, the rule will replicate the behavior of the ul-indent (MD007) rule.
    • Examples:

      • ul_indent: undefined

        * top-level item
          * sub-item
      • ul_indent: 3

        * top-level item
           * sub-item

License

This software is released under the MIT license. See the license file for more details.