Files
ale/doc/ale-markdown.txt
Jason Weir 5dfd1fdb9a Add configurable options support for redpen linter (#5006)
Redpen linter previously had hardcoded command-line options and duplicated
linter definitions across all supported file types (asciidoc, markdown,
review, rst, tex, text). This refactoring centralizes the linter definition
and adds support for user-configurable options via g:ale_redpen_options.

Key changes:
- Created ale#handlers#redpen#DefineLinter() to eliminate code duplication
- Added ale#handlers#redpen#GetCommand() to support configurable options
- All file types now use shared configuration and command building
- Added comprehensive test coverage for option handling
- Updated documentation for all affected file types

This allows users to customize redpen behavior with additional command-line
options while maintaining backward compatibility and reducing maintenance
overhead.
2025-08-13 13:06:06 +01:00

236 lines
9.2 KiB
Plaintext

===============================================================================
ALE Markdown Integration *ale-markdown-options*
===============================================================================
cspell *ale-markdown-cspell*
See |ale-cspell-options|
===============================================================================
dprint *ale-markdown-dprint*
See |ale-dprint-options| and https://dprint.dev/plugins/markdown
===============================================================================
markdownlint *ale-markdown-markdownlint*
*ale-options.markdown_markdownlint_executable*
*g:ale_markdown_markdownlint_executable*
*b:ale_markdown_markdownlint_executable*
markdown_markdownlint_executable
g:ale_markdown_markdownlint_executable
Type: |String|
Default: `'markdownlint'`
Override the invoked `markdownlint` binary. You can use other binaries such as
`markdownlint-cli2`.
*ale-options.markdown_markdownlint_options*
*g:ale_markdown_markdownlint_options*
*b:ale_markdown_markdownlint_options*
markdown_markdownlint_options
g:ale_markdown_markdownlint_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to markdownlint.
===============================================================================
marksman *ale-markdown-marksman*
*ale-options.markdown_marksman_executable*
*g:ale_markdown_marksman_executable*
*b:ale_markdown_marksman_executable*
markdown_marksman_executable
g:ale_markdown_marksman_executable
Type: |String|
Default: `'marksman'`
Override the invoked `marksman` binary.
===============================================================================
mdl *ale-markdown-mdl*
*ale-options.markdown_mdl_executable*
*g:ale_markdown_mdl_executable*
*b:ale_markdown_mdl_executable*
markdown_mdl_executable
g:ale_markdown_mdl_executable
Type: |String|
Default: `'mdl'`
Override the invoked mdl binary. This is useful for running mdl from
binstubs or a bundle.
*ale-options.markdown_mdl_options*
*g:ale_markdown_mdl_options*
*b:ale_markdown_mdl_options*
markdown_mdl_options
g:ale_markdown_mdl_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to mdl.
===============================================================================
pandoc *ale-markdown-pandoc*
*ale-options.markdown_pandoc_executable*
*g:ale_markdown_pandoc_executable*
*b:ale_markdown_pandoc_executable*
markdown_pandoc_executable
g:ale_markdown_pandoc_executable
Type: |String|
Default: `'pandoc'`
This variable can be set to specify where to find the pandoc executable
*ale-options.markdown_pandoc_options*
*g:ale_markdown_pandoc_options*
*b:ale_markdown_pandoc_options*
markdown_pandoc_options
g:ale_markdown_pandoc_options
Type: |String|
Default: `'-f gfm -t gfm -s -'`
This variable can be set to change the default options passed to pandoc
===============================================================================
prettier *ale-markdown-prettier*
See |ale-javascript-prettier| for information about the available options.
===============================================================================
pymarkdown *ale-markdown-pymarkdown*
*ale-options.markdown_pymarkdown_executable*
*g:ale_markdown_pymarkdown_executable*
*b:ale_markdown_pymarkdown_executable*
markdown_pymarkdown_executable
g:ale_markdown_pymarkdown_executable
Type: |String|
Default: `'pymarkdown'`
See |ale-integrations-local-executables|
Set this to `'pipenv'` to invoke `'pipenv` `run` `pymarkdown'`.
Set this to `'poetry'` to invoke `'poetry` `run` `pymarkdown'`.
*ale-options.markdown_pymarkdown_options*
*g:ale_markdown_pymarkdown_options*
*b:ale_markdown_pymarkdown_options*
markdown_pymarkdown_options
g:ale_markdown_pymarkdown_options
Type: |String|
Default: `''`
This variable can be changed to add command-line arguments to the
pymarkdown invocation.
*ale-options.markdown_pymarkdown_use_global*
*g:ale_markdown_pymarkdown_use_global*
*b:ale_markdown_pymarkdown_use_global*
markdown_pymarkdown_use_global
g:ale_markdown_pymarkdown_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
*ale-options.markdown_pymarkdown_auto_pipenv*
*g:ale_markdown_pymarkdown_auto_pipenv*
*b:ale_markdown_pymarkdown_auto_pipenv*
markdown_pymarkdown_auto_pipenv
g:ale_markdown_pymarkdown_auto_pipenv
Type: |Number|
Default: `0`
Detect whether the file is inside a pipenv, and set the executable to `pipenv`
if true. This is overridden by a manually-set executable.
*ale-options.markdown_pymarkdown_auto_poetry*
*g:ale_markdown_pymarkdown_auto_poetry*
*b:ale_markdown_pymarkdown_auto_poetry*
markdown_pymarkdown_auto_poetry
g:ale_markdown_pymarkdown_auto_poetry
Type: |Number|
Default: `0`
Detect whether the file is inside a poetry, and set the executable to `poetry`
if true. This is overridden by a manually-set executable.
*ale-options.markdown_pymarkdown_auto_uv*
*g:ale_markdown_pymarkdown_auto_uv*
*b:ale_markdown_pymarkdown_auto_uv*
markdown_pymarkdown_auto_uv
g:ale_markdown_pymarkdown_auto_uv
Type: |Number|
Default: `0`
Set the executable to `uv` if true. This is overridden by a manually-set
executable.
===============================================================================
remark-lint *ale-markdown-remark-lint*
*ale-options.markdown_remark_lint_executable*
*g:ale_markdown_remark_lint_executable*
*b:ale_markdown_remark_lint_executable*
markdown_remark_lint_executable
g:ale_markdown_remark_lint_executable
Type: |String|
Default: `'remark'`
See |ale-integrations-local-executables|
*ale-options.markdown_remark_lint_options*
*g:ale_markdown_remark_lint_options*
*b:ale_markdown_remark_lint_options*
markdown_remark_lint_options
g:ale_markdown_remark_lint_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to remark-lint.
*ale-options.markdown_remark_lint_use_global*
*g:ale_markdown_remark_lint_use_global*
*b:ale_markdown_remark_lint_use_global*
markdown_remark_lint_use_global
g:ale_markdown_remark_lint_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
textlint *ale-markdown-textlint*
See |ale-text-textlint|
===============================================================================
write-good *ale-markdown-write-good*
See |ale-write-good-options|
===============================================================================
redpen *ale-markdown-redpen*
See |ale-redpen-options|
===============================================================================
vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: