A GitHub Action that performs style checking and linting for Markdown/CommonMark files using markdownlint-cli.
Basic usage with all options enabled:
- name: markdownlint-cli
uses: nosborn/github-action-markdown-cli@v3.0.1
with:
files: .
config: .markdownlint.yaml
disable: MD013 MD041
dot: true
enable: MD013 MD041
ignore: examples/ignore/*
ignore_path: examples/.markdownlintignore
rules: examples/rules/custom.jsfiles- what to process (files, directories, globs)config(optional) - configuration file (JSON or YAML)disable(optional) - disable certain rules, for exampleMD013 MD041dot(optional) - iftrue, include files/folders with a dot (for example.github)enable(optional) - enable certain rules, for exampleMD013 MD041ignore(optional) - files to ignore/exclude (file, directory, glob)ignore_path(optional) - path to file with ignore pattern(s)rules(optional) - custom rule files (file, directory, glob, package)
These inputs are still available but will be removed in a future major version.
config_file(optional) - configuration file (JSON or YAML) - superseded byconfigignore_files(optional) - files to ignore/exclude (file, directory, glob) - superseded byignore
The scripts and documentation in this project are released under the MIT License.