# markdown

> Markdown files: one style and layout, and code blocks that parse.

Markdown files: one style and layout, and code blocks that parse.

## Checks

| Check                                                               | Stage    | Level         | What it does                                                                                                                              |
| ------------------------------------------------------------------- | -------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| [`markdown/markdownlint`](/reference/checks/markdown/markdownlint/) | `commit` | `recommended` | Checks every Markdown file against markdownlint with the shipped rule set.                                                                |
| [`markdown/fences`](/reference/checks/markdown/fences/)             | `commit` | `recommended` | Checks JSON, JSONC, TOML, YAML, Bash, JavaScript, JSX, TypeScript, TSX, and Python code fences in Markdown (.md) files for syntax errors. |

## Settings

| Setting                                                                       | What it sets                                                                                                                                                                        |
| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`tools.markdownlint.rules`](/reference/gspot-toml/#tools.markdownlint.rules) | Option tables by Markdown rule ID, such as MD024; the level decides which rules run. Ignore a finding with gspot ignore markdown/markdownlint `--rule` `<rule>` `--reason` `<why>`. |

## Selected when

gspot selects it in a scope with file extensions `.md`, `.mdx`.

## Tools and versions

| Tool              | Version  |
| ----------------- | -------- |
| markdownlint-cli2 | `0.23.3` |

## Files gspot writes

gspot writes `.gspot/configurations/language/markdown/markdownlint.jsonc` and `.gspot/configurations/language/markdown/markdownlint-cli2.mjs`.