actions/markdownlint-cli2-action
0
0
Fork 0
mirror of https://github.com/DavidAnson/markdownlint-cli2-action.git synced 2024-11-23 22:56:22 +01:00
Code Activity
A GitHub Action to run the markdownlint-cli2 tool for linting Markdown/CommonMark files with the markdownlint library
61 commits 2 branches 39 tags 5.1 MiB
JavaScript 100%
Find a file
dependabot[bot] 2768abdb0a
Bump markdownlint-cli2 from 0.4.0 to 0.5.1 (#16) 
Bumps [markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2) from 0.4.0 to 0.5.1.
- [Release notes](https://github.com/DavidAnson/markdownlint-cli2/releases)
- [Commits](https://github.com/DavidAnson/markdownlint-cli2/compare/v0.4.0...v0.5.1)

---
updated-dependencies:
- dependency-name: markdownlint-cli2
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2022-08-13 12:36:51 -07:00
.github Bump tj-actions/changed-files from 24 to 25 (#14) 2022-08-09 08:37:11 -07:00
config Move .markdownlint.jsonc file to avoid interfering with action tests. 2022-07-22 23:16:36 -07:00
dist Add "command" input to allow invoking -fix and -config commands (fixes #7, fixes #8). 2022-07-21 22:24:48 -07:00
test Add passing/failing file and no/one glob to tests. 2021-01-13 14:29:36 -08:00
.eslintrc.json Update dependencies: actions/core to 1.9.0, @vercel/ncc to 0.34.0, eslint to 8.20.0, eslint-plugin-unicorn to 43.0.2. 2022-07-19 20:54:12 -07:00
.gitignore Minor cleanup of unused/irrelevant components. 2021-01-13 14:17:17 -08:00
.npmrc Default to package-lock=false in .npmrc. 2021-02-20 19:02:26 -08:00
action.yml Remove unnecessary quotes from YAML code/examples, standardize on single (vs. double) quotes, add test for invalid configuration file. 2022-07-23 13:28:59 -07:00
LICENSE Update copyright year for 2022. 2022-01-22 15:36:45 -08:00
markdownlint-cli2-action.js Add "command" input to allow invoking -fix and -config commands (fixes #7, fixes #8). 2022-07-21 22:24:48 -07:00
package.json Bump markdownlint-cli2 from 0.4.0 to 0.5.1 (#16) 2022-08-13 12:36:51 -07:00
README.md Add example workflow demonstrating linting only changed files (closes #12). 2022-07-31 11:28:56 -07:00

README.md

markdownlint-cli2-action

A GitHub Action to run the markdownlint-cli2 tool for linting Markdown/CommonMark files with markdownlint

markdownlint-cli2 has extensive support for configuring options and disabling or customizing markdownlint rules. See the markdownlint-cli2 README for more information. markdownlint includes a wide variety of rules for analyzing and improving Markdown content. See the markdownlint README for more information.

Inputs

command (optional)

Command to run (unset, fix, or config)

If unspecified or "", the markdownlint-cli2 command is run.

If set to fix, the markdownlint-cli2-fix command is run and supported issues will be fixed automatically.

If set to config, the markdownlint-cli2-config command is run and the first element of globs should specify a supported configuration file.

For more detail: documentation for markdownlint-cli2.

globs (optional)

Glob expression(s) of files to lint (newline-delimited)

The default *.{md,markdown} lints all Markdown files in the base directory of a project.

For more detail: glob syntax in markdownlint-cli2.

Outputs

[None]

Examples

To lint Markdown files in the base directory of a project:

- uses: DavidAnson/markdownlint-cli2-action@v6

To lint all Markdown files in a project:

- uses: DavidAnson/markdownlint-cli2-action@v6
  with:
    globs: '**/*.md'

To lint specific Markdown files in a project:

- uses: DavidAnson/markdownlint-cli2-action@v6
  with:
    globs: |
      README.md
      CHANGELOG.md
      docs/*.md

To fix supported issues when linting:

- uses: DavidAnson/markdownlint-cli2-action@v6
  with:
    command: fix
    globs: '**/*.md'

To specify a custom configuration file:

- uses: DavidAnson/markdownlint-cli2-action@v6
  with:
    command: config
    globs: |
      config/custom.markdownlint.jsonc
      **/*.md

To prevent linting issues from failing the workflow run:

- uses: DavidAnson/markdownlint-cli2-action@v6
  continue-on-error: true

See example.yml for a simple GitHub workflow that uses markdownlint-cli2-action.

See changed.yml for a GitHub workflow that lints only the Markdown files that changed in the most recent commit (useful for Pull Requests and/or gradually introducing linting rules to a new repository).