https://github.com/hougesen/mdsf

Format markdown code blocks using your favorite tools
https://github.com/hougesen/mdsf

cli codeblocks codeformatter command-line documentation elixir formatter gleam go hacktoberfest json markdown md pretty-printer python rust typescript zig

Last synced: 3 months ago
JSON representation

Format markdown code blocks using your favorite tools

Host: GitHub
URL: https://github.com/hougesen/mdsf
Owner: hougesen
License: mit
Created: 2024-02-18T17:01:41.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2025-04-01T20:55:00.000Z (about 1 year ago)
Last Synced: 2025-04-01T22:57:17.671Z (about 1 year ago)
Topics: cli, codeblocks, codeformatter, command-line, documentation, elixir, formatter, gleam, go, hacktoberfest, json, markdown, md, pretty-printer, python, rust, typescript, zig
Language: Rust
Homepage: https://mdsf.mhouge.dk
Size: 3.52 MB
Stars: 45
Watchers: 3
Forks: 1
Open Issues: 16
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

trackawesomelist - mdsf (⭐22)
awesome-python-code-formatters - mdsf
fucking-static-analysis - mdsf
static-analysis - mdsf
awesome-markdown - mdsf - Use your preferred code formatter to format markdown code snippets. (Markdown Building Blocks / Markdown Lint / Style Rule Checker)

README

# mdsf

Format, and lint, markdown code snippets using your favorite tools.

## Table of contents

- [Table of contents](#table-of-contents)
- [Installation](#installation)
- [Linux & MacOS](#linux--macos)
- [Windows](#windows)
- [Cargo](#cargo)
- [npm/npx](#npmnpx)
- [Homebrew](#homebrew)
- [Conda](#conda)
- [Usage](#usage)
- [Formatting code](#formatting-code)
- [Caching formatting results](#caching-formatting-results)
- [Removing old caches](#removing-old-caches)
- [Verifying code](#verifying-code)
- [GitHub Action](#github-action)
- [Visual Studio Code](#visual-studio-code)
- [Vim / NeoVim](#vim--neovim)
- [conform.nvim](#conformnvim)
- [treefmt](#treefmt)
- [pre-commit](#pre-commit)
- [Configuration](#configuration)
- [Language aliases](#language-aliases)
- [Newlines](#newlines)
- [Custom tools and commands](#custom-tools-and-commands)
- [Tools](#tools)
- [Commands](#commands)
- [Shell completions](#shell-completions)
- [Bash](#bash)
- [Zsh](#zsh)
- [Fish](#fish)
- [PowerShell](#powershell)
- [Elvish](#elvish)
- [Nushell](#nushell)
- [Rust MSRV](#rust-msrv)
- [Acknowledgement](#acknowledgement)
- [Alternatives to mdsf](#alternatives-to-mdsf)

## Installation

The latest version of `mdsf` can be downloaded directly from [github.com/hougesen/mdsf/releases](https://github.com/hougesen/mdsf/releases).

### Linux & MacOS

```shell
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/hougesen/mdsf/releases/latest/download/mdsf-installer.sh | sh
```

### Windows

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://github.com/hougesen/mdsf/releases/latest/download/mdsf-installer.ps1 | iex"
```

### Cargo

Install using the [published crate](https://crates.io/crates/mdsf):

```shell
cargo install mdsf --locked
```

or directly from source:

```shell
git clone git@github.com:hougesen/mdsf.git

cargo install --path ./mdsf --bin mdsf
```

If you do not have Cargo installed, you need to [install it first](https://www.rust-lang.org/learn/get-started).

### npm/npx

You can install `mdsf` using [npm](https://www.npmjs.com/package/mdsf-cli):

```shell
npm install -g mdsf-cli

mdsf format .
```

or run it directly using npx:

```shell
npx mdsf-cli format .
```

### Homebrew

```shell
brew install hougesen/tap/mdsf
```

### Conda

An _unofficial_ (and unsupported) Conda package can be found at [https://anaconda.org/conda-forge/mdsf](https://anaconda.org/conda-forge/mdsf).

```shell
conda install conda-forge::mdsf
```

## Usage

```
mdsf 0.12.0-next
Format, and lint, markdown code snippets using your favorite tools
Mads Hougesen

Usage: mdsf [OPTIONS]

Commands:
format Run tools on input files
verify Verify files are formatted
init Create a new mdsf config
completions Generate shell completion
cache-prune Remove caches
help Print this message or the help of the given subcommand(s)

Options:
--log-level [default: debug] [possible values: trace, debug, info, warn, error, off]
-h, --help Print help
-V, --version Print version
```

### Formatting code

The `format` command, as the name implies, is used to format documents.

```shell
mdsf format file.md
```

```
Run tools on input files

Usage: mdsf format [OPTIONS] [INPUT]...

Arguments:
[INPUT]...
Path to files and/or directories

Options:
--stdin
Read input from stdin and write output to stdout

--config
Path to config file

--debug
Log stdout and stderr of formatters

--threads
Amount of threads to use.

Defaults to 0 (auto).

--cache
Cache results

--log-level
[default: debug]
[possible values: trace, debug, info, warn, error, off]

--timeout
Tool timeout in seconds.

Defaults to no timeout.

--on-missing-language-definition
What to do when a codeblock language has no tools defined.

Falls back to the value defined in your config file, if no argument is provided.

[possible values: ignore, fail, fail-fast]

--on-missing-tool-binary
What to do when the binary of a tool cannot be found.

Falls back to the value defined in your config file, if no argument is provided.

[possible values: ignore, fail, fail-fast]

-h, --help
Print help (see a summary with '-h')

-V, --version
Print version
```

#### Caching formatting results

To speed formatting caching can be enabled by supplying the `format` command with the `--cache` argument.

```shell
mdsf format --cache docs/
```

##### Removing old caches

Old caches can be removed by running the `mdsf cache-prune` command.

```
Remove caches

Usage: mdsf cache-prune [OPTIONS]

Options:
--log-level [default: debug] [possible values: trace, debug, info, warn, error, off]
-h, --help Print help
-V, --version Print version
```

### Verifying code

You can verify that the document is formatted using the `mdsf verify` command.

```shell
mdsf verify docs/
```

```
Verify files are formatted

Usage: mdsf verify [OPTIONS] [INPUT]...

Arguments:
[INPUT]...
Path to files and/or directories

Options:
--stdin
Read input from stdin and write output to stdout

--config
Path to config file

--debug
Log stdout and stderr of formatters

--threads
Amount of threads to use.

Defaults to 0 (auto).

--timeout
Tool timeout in seconds.

Defaults to no timeout.

--log-level
[default: debug]
[possible values: trace, debug, info, warn, error, off]

--on-missing-language-definition
What to do when a codeblock language has no tools defined.

Falls back to the value defined in your config file, if no argument is provided.

[possible values: ignore, fail, fail-fast]

--on-missing-tool-binary
What to do when the binary of a tool cannot be found.

Falls back to the value defined in your config file, if no argument is provided.

[possible values: ignore, fail, fail-fast]

-h, --help
Print help (see a summary with '-h')

-V, --version
Print version
```

### GitHub Action

There are a lot of different ways to run `mdsf` using GitHub actions.

The easiest way, in my opinion, is to use the official GitHub action to install mdsf.

After that you can run the binary like you would in your terminal.

> \[!NOTE\]
> mdsf is not a package manager.
>
> You must also install the tools you wish to use in your GitHub action.

```yaml
name: mdsf

on: push

jobs:
format:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Install mdsf
uses: hougesen/mdsf@main

- name: Run mdsf
run: mdsf format --log-level warn .

- name: Commit changes
uses: EndBug/add-and-commit@v9
with:
message: "style: formatted markdown code blocks"
```

### Visual Studio Code

[![](https://img.shields.io/visual-studio-marketplace/v/hougesen.mdsf?color=374151&label=Visual%20Studio%20Marketplace&labelColor=000&logo=visual-studio-code&logoColor=0098FF)](https://marketplace.visualstudio.com/items?itemName=hougesen.mdsf)
[![](https://img.shields.io/visual-studio-marketplace/v/hougesen.mdsf?color=374151&label=Open%20VSX%20Registry&labelColor=000&logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPHN2ZyB2aWV3Qm94PSI0LjYgNSA5Ni4yIDEyMi43IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgogIDxwYXRoIGQ9Ik0zMCA0NC4yTDUyLjYgNUg3LjN6TTQuNiA4OC41aDQ1LjNMMjcuMiA0OS40em01MSAwbDIyLjYgMzkuMiAyMi42LTM5LjJ6IiBmaWxsPSIjYzE2MGVmIi8+CiAgPHBhdGggZD0iTTUyLjYgNUwzMCA0NC4yaDQ1LjJ6TTI3LjIgNDkuNGwyMi43IDM5LjEgMjIuNi0zOS4xem01MSAwTDU1LjYgODguNWg0NS4yeiIgZmlsbD0iI2E2MGVlNSIvPgo8L3N2Zz4=&logoColor=0098FF)](https://open-vsx.org/extension/hougesen/mdsf)

mdsf can be run using the VSCode extension.

> \[!NOTE\]
> The mdsf VS Code extension does currently not support installing mdsf.
> Which means mdsf must be installed using other means.

### Vim / NeoVim

#### conform.nvim

[conform.nvim](https://github.com/stevearc/conform.nvim) has native support for running mdsf.

```lua
local conform = require("conform")

conform.setup({
formatters_by_ft = {
markdown = { "mdsf" },
-- ...
},
-- ...
})
```

### treefmt

Add the following to your `treefmt.toml` to run mdsf using [treefmt](https://github.com/numtide/treefmt).

```toml
# treefmt.toml

[formatter.mdsf]
command = "mdsf"
options = ["format"]
includes = ["*.md"]
```

### pre-commit

See [pre-commit](https://github.com/pre-commit/pre-commit) for instructions

Sample `.pre-commit-config.yaml`:

```yaml
repos:
- repo: https://github.com/hougesen/mdsf
rev: main
hooks:
- id: mdsf-format
```

## Configuration

The default configuration of `mdsf` aims to as simple as possible. For that reason the default formatter for each language is the one most people have installed.

If you are interested in customizing which formatter is run, you can create a new `mdsf` configuration file by running `mdsf init`.

```
Create a new mdsf config

Usage: mdsf init [OPTIONS]

Options:
--force
Create config even if one already exists in current directory
--format
[default: json] [possible values: json, toml, yaml]
--schema-version
[default: locked] [possible values: locked, stable, development]
--log-level
[default: debug] [possible values: trace, debug, info, warn, error, off]
-h, --help
Print help
-V, --version
Print version
```

`mdsf` supports running multiple formatters on the code snippet.

```json
{
"languages": {
// Only run `ruff` on Python snippets,
"python": "ruff:format",
// Run `usort` on file and then `black`
"python": ["usort", "black"],
// Run `usort`, if that fails run `isort`, finally run `black`
"python": [["usort", "isort"], "black"],

// Formatters listed under "*" will be run on any snippet.
"*": ["typos"],

// Formatters listed under "_" will only be run when there is not formatter configured for the file type OR globally ("*").
"_": "prettier"
}
}
```

### Language aliases

Multiple languages can easily be mapped to the same tools using the `language_aliases` option.

```json
{
"language_aliases": {
"language": "is_alias_of"
}
}
```

In the example below `bash` and `zsh` would use the tools defined under `languages.shell`.

```json
{
"languages": {
"shell": "shfmt"
},
"language_aliases": {
"bash": "shell",
"zsh": "shell"
}
}
```

### Newlines

By default LF (`\n`) is used for newlines.

That can be changed by specifying the `newline` config option.

```json
{
"newline": "lf" // "lf" | "cr" | "crlf"
}
```

### Custom tools and commands

Custom commands can be defined in the `mdsf.json` file.

When defining the arguments the variable `$PATH` will automatically be replaced with the file path.

```json
{
"languages": {
"rust": {
"binary": "rustfmt",
"arguments": ["--edition", "2018", "$PATH"],
"stdin": false
}
}
}
```

### Tools

> \[!NOTE\]
> mdsf is not a package manager.
>
> Only tools that are already installed will be used.

`mdsf` currently supports 346 tools. Feel free to open an issue/pull-request if your favorite tool/command is missing! 😃

| Name
| ------------------------------------------------
| [action-validator](https://github.com/mpalmer/ac
| [actionlint](https://github.com/rhysd/actionlint)
| [air](https://github.com/posit-dev/air)
| [alejandra](https://github.com/kamadorueda/alejandra)
| [alex](https://github.com/get-alex/alex)
| [ameba](https://github.com/crystal-ameba/ameba)
| [ansible-lint](https://github.com/ansible/ansible-lint)
| [api-linter](https://github.com/googleapis/api-linter)
| [asmfmt](https://github.com/klauspost/asmfmt)
| [astyle](https://gitlab.com/saalen/astyle)
| [atlas](https://github.com/ariga/atlas)
| [auto-optional](https://github.com/luttik/auto-optional)
| [autocorrect](https://github.com/huacnlee/autocorrect)
| [autoflake](https://github.com/pycqa/autoflake)
| [autopep8](https://github.com/hhatto/autopep8)
| [bashate](https://github.com/openstack/bashate)
| [beancount-black](https://github.com/launchplatf
| [beautysh](https://github.com/lovesegfault/beautysh)
| [bibtex-tidy](https://github.com/flamingtempura/bibtex-tidy)
| [bicep](https://github.com/azure/bicep)
| [biome](https://github.com/biomejs/biome)
| [black](https://github.com/psf/black)
| [blade-formatter](https://github.com/shufo/blade-formatter)
| [blue](https://github.com/grantjenks/blue)
| [bpfmt](https://source.android.com/docs/setup/re
| [brittany](https://github.com/lspitzner/brittany)
| [brunette](https://pypi.org/project/brunette)
| [bsfmt](https://github.com/rokucommunity/brighte
| [bslint](https://github.com/rokucommunity/bslint)
| [buf](https://buf.build/docs/reference/cli/buf)
| [buildifier](https://github.com/bazelbuild/buildtools)
| [c3fmt](https://github.com/lmichaudel/c3fmt)
| [cabal-fmt](https://github.com/phadej/cabal-fmt)
| [cabal-gild](https://github.com/tfausak/cabal-gild)
| [cabal-prettify](https://github.com/kindaro/cabal-prettify)
| [cabal](https://www.haskell.org/cabal)
| [caddy](https://caddyserver.com/docs/command-line#caddy-fmt)
| [caramel](https://caramel.run)
| [cedar](https://github.com/cedar-policy/cedar)
| [cfn-lint](https://github.com/aws-cloudformation/cfn-lint)
| [checkmake](https://github.com/mrtazz/checkmake)
| [clang-format](https://clang.llvm.org/docs/ClangFormat.html)
| [clang-tidy](https://clang.llvm.org/extra/clang-tidy)
| [clj-kondo](https://github.com/clj-kondo/clj-kondo)
| [cljfmt](https://github.com/weavejester/cljfmt)
| [cljstyle](https://github.com/greglook/cljstyle)
| [cmake-format](https://cmake-format.readthedocs.
| [cmake-lint](https://cmake-format.readthedocs.io
| [codeql](https://docs.github.com/en/code-securit
| [codespell](https://github.com/codespell-project/codespell)
| [coffeelint](https://github.com/coffeelint/coffeelint)
| [cppcheck](https://cppcheck.sourceforge.io)
| [cpplint](https://github.com/cpplint/cpplint)
| [crlfmt](https://github.com/cockroachdb/crlfmt)
| [crystal](https://crystal-lang.org)
| [csharpier](https://github.com/belav/csharpier)
| [css-beautify](https://github.com/beautifier/js-beautify)
| [csscomb](https://github.com/csscomb/csscomb.js)
| [csslint](https://github.com/csslint/csslint)
| [cue](https://github.com/cue-lang/cue)
| [cueimports](https://github.com/asdine/cueimports)
| [curlylint](https://github.com/thibaudcolas/curlylint)
| [d2](https://d2lang.com)
| [dart](https://dart.dev/tools)
| [dcm](https://dcm.dev)
| [deadnix](https://github.com/astro/deadnix)
| [deno](https://docs.deno.com/runtime/reference/cli)
| [dfmt](https://github.com/dlang-community/dfmt)
| [dhall](https://dhall-lang.org)
| [djade](https://github.com/adamchainz/djade)
| [djangofmt](https://github.com/unknownplatypus/djangofmt)
| [djlint](https://www.djlint.com)
| [docformatter](https://github.com/pycqa/docformatter)
| [dockerfmt](https://github.com/reteps/dockerfmt)
| [dockfmt](https://github.com/jessfraz/dockfmt)
| [docstrfmt](https://github.com/lilspazjoekp/docstrfmt)
| [doctoc](https://github.com/thlorenz/doctoc)
| [dotenv-linter](https://github.com/dotenv-linter
| [dprint](https://dprint.dev)
| [dscanner](https://github.com/dlang-community/d-scanner)
| [dune](https://github.com/ocaml/dune)
| [duster](https://github.com/tighten/duster)
| [dx](https://github.com/dioxuslabs/dioxus)
| [easy-coding-standard](https://github.com/easy-c
| [efmt](https://github.com/sile/efmt)
| [elm-format](https://github.com/avh4/elm-format)
| [eradicate](https://github.com/pycqa/eradicate)
| [erb-formatter](https://github.com/nebulab/erb-formatter)
| [erg](https://github.com/erg-lang/erg)
| [erlfmt](https://github.com/whatsapp/erlfmt)
| [eslint](https://github.com/eslint/eslint)
| [fantomas](https://github.com/fsprojects/fantomas)
| [fish_indent](https://fishshell.com/docs/current
| [fixjson](https://github.com/rhysd/fixjson)
| [floskell](https://github.com/ennocramer/floskell)
| [flynt](https://github.com/ikamensh/flynt)
| [fnlfmt](https://git.sr.ht/~technomancy/fnlfmt)
| [forge](https://github.com/foundry-rs/foundry)
| [fortitude](https://github.com/plasmafair/fortitude)
| [fortran-linter](https://github.com/cphyc/fortran-linter)
| [fourmolu](https://github.com/fourmolu/fourmolu)
| [fprettify](https://github.com/fortran-lang/fprettify)
| [futhark](https://futhark.readthedocs.io/en/late
| [fvm](https://github.com/leoafarias/fvm)
| [gci](https://github.com/daixiang0/gci)
| [gdformat](https://github.com/scony/godot-gdscript-toolkit)
| [gdlint](https://github.com/scony/godot-gdscript-toolkit)
| [gersemi](https://github.com/blankspruce/gersemi)
| [ghokin](https://github.com/antham/ghokin)
| [gleam](https://gleam.run)
| [gluon](https://github.com/gluon-lang/gluon)
| [gofmt](https://pkg.go.dev/cmd/gofmt)
| [gofumpt](https://github.com/mvdan/gofumpt)
| [goimports-reviser](https://github.com/incu6us/g
| [goimports](https://pkg.go.dev/golang.org/x/tool
| [golangci-lint](https://github.com/golangci/golangci-lint)
| [golines](https://github.com/golangci/golines)
| [google-java-format](https://github.com/google/g
| [gospel](https://github.com/kortschak/gospel)
| [grafbase](https://github.com/grafbase/grafbase)
| [grain](https://grain-lang.org/docs/tooling/grain_cli)
| [hadolint](https://github.com/hadolint/hadolint)
| [haml-lint](https://github.com/sds/haml-lint)
| [hclfmt](https://github.com/hashicorp/hcl)
| [hfmt](https://github.com/danstiner/hfmt)
| [hindent](https://github.com/mihaimaruseac/hindent)
| [hlint](https://github.com/ndmitchell/hlint)
| [hongdown](https://github.com/dahlia/hongdown)
| [html-beautify](https://github.com/beautifier/js-beautify)
| [htmlbeautifier](https://github.com/threedaymonk
| [htmlhint](https://github.com/htmlhint/htmlhint)
| [hurlfmt](https://hurl.dev)
| [imba](https://imba.io)
| [inko](https://github.com/inko-lang/inko)
| [isort](https://github.com/timothycrosley/isort)
| [janet-format](https://github.com/janet-lang/spork)
| [joker](https://github.com/candid82/joker)
| [jq](https://github.com/jqlang/jq)
| [jqfmt](https://github.com/noperator/jqfmt)
| [js-beautify](https://github.com/beautifier/js-beautify)
| [json5format](https://github.com/google/json5format)
| [json_repair](https://github.com/mangiucugna/json_repair)
| [jsona](https://github.com/jsona/jsona)
| [jsonlint](https://github.com/zaach/jsonlint)
| [jsonnet-lint](https://jsonnet.org/learning/tools.html)
| [jsonnetfmt](https://jsonnet.org/learning/tools.html)
| [jsonpp](https://github.com/jmhodges/jsonpp)
| [juliaformatter.jl](https://github.com/domluna/j
| [just](https://github.com/casey/just)
| [kcl](https://www.kcl-lang.io/docs/tools/cli/kcl/fmt)
| [kdlfmt](https://github.com/hougesen/kdlfmt)
| [kdoc-formatter](https://github.com/tnorbye/kdoc-formatter)
| [keep-sorted](https://github.com/google/keep-sorted)
| [ktfmt](https://github.com/facebook/ktfmt)
| [ktlint](https://github.com/pinterest/ktlint)
| [kube-linter](https://github.com/stackrox/kube-linter)
| [kulala-fmt](https://github.com/mistweaverco/kulala-fmt)
| [leptosfmt](https://github.com/bram209/leptosfmt)
| [liquidsoap-prettier](https://github.com/savonet
| [luacheck](https://github.com/lunarmodules/luacheck)
| [luaformatter](https://github.com/koihik/luaformatter)
| [luau-analyze](https://luau.org)
| [mado](https://github.com/akiomik/mado)
| [mago](https://github.com/carthage-software/mago)
| [markdownfmt](https://github.com/shurcool/markdownfmt)
| [markdownlint-cli2](https://github.com/davidanso
| [markdownlint](https://github.com/davidanson/markdownlint)
| [markuplint](https://markuplint.dev)
| [mbake](https://github.com/ebodshojaei/bake)
| [md-padding](https://github.com/harttle/md-padding)
| [mdformat](https://github.com/executablebooks/mdformat)
| [mdsf](https://github.com/hougesen/mdsf)
| [mdslw](https://github.com/razziel89/mdslw)
| [meson](https://mesonbuild.com)
| [mh_lint](https://github.com/florianschanda/miss_hit)
| [mh_style](https://github.com/florianschanda/miss_hit)
| [mise](https://github.com/jdx/mise)
| [misspell](https://github.com/client9/misspell)
| [mix](https://hexdocs.pm/mix/main/Mix.Tasks.Format.html)
| [mojo](https://docs.modular.com/mojo/cli/format)
| [muon](https://github.com/muon-build/muon)
| [mypy](https://github.com/python/mypy)
| [nasmfmt](https://github.com/yamnikov-oleg/nasmfmt)
| [nginxbeautifier](https://github.com/vasilevich/
| [nginxfmt](https://github.com/slomkowski/nginx-c
| [nickel](https://nickel-lang.org)
| [nimpretty](https://github.com/nim-lang/nim)
| [nixfmt](https://github.com/nixos/nixfmt)
| [nixpkgs-fmt](https://github.com/nix-community/nixpkgs-fmt)
| [nomad](https://developer.hashicorp.com/nomad/docs/commands)
| [nph](https://github.com/arnetheduck/nph)
| [npm-groovy-lint](https://github.com/nvuillam/np
| [nufmt](https://github.com/nushell/nufmt)
| [ocamlformat](https://github.com/ocaml-ppx/ocamlformat)
| [ocp-indent](https://github.com/ocamlpro/ocp-indent)
| [odinfmt](https://github.com/danielgavin/ols)
| [oelint-adv](https://github.com/priv-kweihmann/oelint-adv)
| [opa](https://www.openpolicyagent.org/docs/latest/cli)
| [ormolu](https://github.com/tweag/ormolu)
| [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html)
| [oxlint](https://oxc.rs/docs/guide/usage/linter.html)
| [packer](https://developer.hashicorp.com/packer/
| [panache](https://github.com/jolars/panache)
| [pasfmt](https://github.com/integrated-applicati
| [perflint](https://github.com/tonybaloney/perflint)
| [perltidy](https://github.com/perltidy/perltidy)
| [pg_format](https://github.com/darold/pgformatter)
| [php-cs-fixer](https://github.com/php-cs-fixer/php-cs-fixer)
| [phpcbf](https://github.com/phpcsstandards/php_codesniffer)
| [phpinsights](https://github.com/nunomaduro/phpinsights)
| [pint](https://github.com/laravel/pint)
| [pkl](https://github.com/apple/pkl)
| [prettier](https://github.com/prettier/prettier) | Description | Categories | Languages | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------- | tion-validator) | Tool to validate GitHub Action and Workflow YAML files | `linter` | `yaml` | | Static checker for GitHub Actions workflow files | `linter` | `yaml` | | R formatter | `formatter` | `r` | | The Uncompromising Nix Code Formatter | `formatter` | `nix` | | Catch insensitive, inconsiderate writing | `spell-check` | `markdown` | | A static code analysis tool for Crystal | `linter` | `crystal` | | ansible-lint checks playbooks for practices and behavior that could potentially be improved and can fix some of the most common ones for you | `linter` | `ansible` | | A linter for APIs defined in protocol buffers | `linter` | `protobuf` | | Go Assembler Formatter | `formatter` | `go` | | A Free, Fast, and Small Automatic Formatter for C, C++, C++/CLI, Objective-C, C#, and Java Source Code | `formatter` | `c#`, `c++`, `c`, `java`, `objective-c` | | Manage your database schema as code | `formatter` | `hcl` | | Makes typed arguments Optional when the default argument is None | `formatter` | `python` | | A linter and formatter to help you to improve copywriting, correct spaces, words, and punctuations between CJK (Chinese, Japanese, Korean) | `spell-check` | | | Removes unused imports and unused variables as reported by pyflakes | `linter` | `python` | | A tool that automatically formats Python code to conform to the PEP 8 style guide | `formatter` | `python` | | Code style enforcement for bash programs | `formatter` | `bash` | orm/beancount-black) | Opinionated code formatter, just like Python's black code formatter but for Beancount | `formatter` | `beancount` | | A Bash beautifier for the masses | `formatter` | `bash`, `shell` | | Cleaner and Formatter for BibTeX files | `formatter` | `bibtex` | | Bicep is a declarative language for describing and deploying Azure resources | `formatter` | `bicep` | | A toolchain for web projects | `formatter`, `linter` | `javascript`, `json`, `typescript`, `vue` | | The uncompromising Python code formatter | `formatter` | `python` | | An opinionated blade template formatter for Laravel that respects readability | `formatter` | `blade`, `laravel`, `php` | | The slightly less uncompromising Python code formatter | `formatter` | `python` | ference/androidbp#formatter) | A formatter for Blueprint files | `formatter` | `blueprint` | | Haskell source code formatter | `formatter` | `haskell` | | A best practice Python code formatter | `formatter` | `python` | rscript-formatter) | A code formatter for BrighterScript (and BrightScript) | `formatter` | `brighterscript`, `brightscript` | | A linter for BrightScript and BrighterScript | `linter` | `brightscript`, `brightscripter` | | The best way of working with Protocol Buffers | `formatter` | `protobuf` | | A bazel BUILD file formatter and editor | `formatter` | `bazel` | | A customizable code formatter for the C3 language | `formatter` | `c3` | | An experiment of formatting .cabal files | `formatter` | `cabal` | | Format Haskell package descriptions | `formatter` | `cabal`, `haskell` | | Prettify your Cabal package configuration files | `formatter` | `cabal` | | Cabal is a system for building and packaging Haskell libraries and programs | `formatter` | `cabal` | | Formats or prettifies a Caddyfile | `formatter` | `caddy` | | Formatter for the Caramel programming language | `formatter` | `caramel` | | Command Line Interface for Cedar | `formatter` | `cedar` | | CloudFormation Linter | `linter` | `cloudformation`, `json`, `yaml` | | Linter/analyzer for Makefiles | `linter` | `makefile` | | A tool to format C/C++/Java/JavaScript/JSON/Objective-C/Protobuf/C# code | `formatter` | `c#`, `c++`, `c`, `java`, `javascript`, `json`, `objective-c`, `protobuf` | | clang-tidy is a clang-based C++ “linter” tool | `linter` | `c++` | | Static analyzer and linter for Clojure code that sparks joy | `linter` | `clojure`, `clojurescript` | | A tool for formatting Clojure code | `formatter` | `clojure` | | A tool for formatting Clojure code | `formatter` | `clojure` | io/en/latest/cmake-format.html) | cmake-format can format your listfiles nicely so that they don't look like crap | `formatter` | `cmake` | /en/latest/lint-usage.html) | Lint CMake files | `linter` | `cmake` | y/codeql-cli/codeql-cli-manual) | Format queries and libraries with CodeQL | `formatter` | `codeql` | | Check code for common misspellings | `spell-check` | | | Lint your CoffeeScript | `linter` | `coffeescript` | | Cppcheck is a static analysis tool for C/C++ code | `linter` | `c++`, `c` | | Static code checker for C++ | `linter` | `c++` | | Formatter for CockroachDB's additions to the Go style guide | `formatter` | `go` | | Tools for the Crystal programming language | `formatter` | `crystal` | | CSharpier is an opinionated code formatter for C# | `formatter` | `c#` | | A CSS formatter | `formatter` | `css` | | CSS coding style formatter | `formatter` | `css` | | Automated linting of Cascading Stylesheets | `linter` | `css` | | The home of the CUE language! Validate and define text-based and dynamic configuration | `formatter` | `cue` | | CUE tool that updates your import lines, adding missing ones and removing unused ones | `formatter` | `cue` | | Experimental HTML templates linting for Jinja, Nunjucks, Django templates, Twig, Liquid | `linter` | `django`, `html`, `jinja`, `liquid`, `nunjucks`, `twig` | | A modern language that turns text to diagrams | `formatter` | `d2` | | Formatter and linter for Dart | `formatter`, `linter` | `dart`, `flutter` | | Code Quality Tool for Flutter Developers | `formatter`, `linter` | `dart`, `flutter` | | Scan Nix files for dead code | `linter` | `nix` | | Formatter and linter for JavaScript and TypeScript | `formatter`, `linter` | `javascript`, `json`, `typescript` | | Dfmt is a formatter for D source code | `formatter` | `d` | | Tools for the Dhall configuration language | `formatter` | `dhall` | | A Django template formatter | `formatter` | `django`, `python` | | A fast, HTML aware, Django template formatter | `formatter` | `django`, `html`, `python` | | Lint & Format HTML Templates | `formatter`, `linter` | `handlebars`, `html`, `jinja`, `mustache`, `nunjucks`, `twig` | | Formats docstrings to follow PEP 257 | `formatter` | `python` | | Dockerfile formatter. a modern dockfmt | `formatter` | `docker` | | Dockerfile format and parser. Like `gofmt` but for Dockerfiles | `formatter` | `docker` | | A formatter for reStructuredText | `formatter` | `python`, `restructuredtext`, `sphinx` | | Generates table of contents for markdown files | `formatter` | `markdown` | /dotenv-linter) | Lightning-fast linter for .env files | `linter` | `env` | | A pluggable and configurable code formatting platform written in Rust | `formatter` | | | Swiss-army knife for D source code | `linter` | `d` | | Build tool for OCaml projects | `formatter` | `dune`, `ocaml`, `reasonml` | | Automatic configuration for Laravel apps to apply Tighten's standard linting & code standards | `formatter`, `linter` | `php` | | Fullstack app framework for web, desktop, and mobile | `formatter` | `rsx`, `rust` | oding-standard/easy-coding-standard) | The Easiest way to add coding standard to your PHP project | `formatter`, `linter` | `php` | | Erlang code formatter | `formatter` | `erlang` | | elm-format formats Elm source code according to a standard set of rules based on the official Elm Style Guide | `formatter` | `elm` | | Removes commented-out code from Python files | `linter` | `python` | | Format ERB files with speed and precision | `formatter` | `erb`, `ruby` | | A statically typed language compatible with Python | `linter` | `erg` | | An automated code formatter for Erlang | `formatter` | `erlang` | | Find and fix problems in your JavaScript code | `linter` | `javascript`, `typescript` | | FSharp source code formatter | `formatter` | `f#` | /cmds/fish_indent.html) | Fish indenter and prettifier | `formatter` | `fish` | | JSON Fixer for Humans using (relaxed) JSON5 | `formatter`, `linter` | `json5`, `json` | | Floskell is a flexible Haskell source code pretty printer | `formatter` | `haskell` | | A tool to automatically convert old string literal formatting to f-strings | `formatter` | `python` | | A formatter for Fennel code | `formatter` | `fennel` | | Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust | `formatter` | `solidity` | | A Fortran linter | `linter` | `fortran` | | A simple fortran syntax checker, including automatic fixing of the code | `formatter`, `linter` | `fortran` | | A fourk of ormolu that uses four space indentation and allows arbitrary configuration | `formatter` | `haskell` | | Auto-formatter for modern Fortran source code | `formatter` | `fortran` | st/man/futhark-fmt.html) | Code formatter for the furhark programming language | `formatter` | `futhark` | | Flutter Version Management: A simple CLI to manage Flutter SDK versions | `formatter`, `linter` | `dart`, `flutter` | | GCI, a tool that control golang package import order and make it always deterministic | `formatter` | `go` | | GDScript formatter | `formatter` | `gdscript` | | GDScript linter | `linter` | `gdscript` | | A formatter to make your CMake code the real treasure | `formatter` | `cmake` | | Parallelized formatter with no external dependencies for gherkin (cucumber, behat...) | `formatter` | `behat`, `cucumber`, `gherkin` | | Format Gleam source code | `formatter` | `gleam` | | A static, type inferred and embeddable language written in Rust | `formatter` | `gluon` | | Gofmt formats Go programs | `formatter` | `go` | | A stricter gofmt | `formatter` | `go` | oimports-reviser) | Right imports sorting & code formatting tool (goimports alternative) | `formatter` | `go` | s/cmd/goimports) | goimports updates your Go import lines, adding missing ones and removing unreferenced ones | `formatter` | `go` | | Fast linters runner for Go | `formatter`, `linter` | `go` | | A golang formatter that fixes long lines | `formatter` | `go` | oogle-java-format) | Reformats Java source code to comply with Google Java Style | `formatter` | `java` | | Misspelled word linter for Go comments, string literals and embedded files | `spell-check` | `go` | | The Grafbase command line interface | `linter` | `graphql` | | Code formatter for the Grain programming language | `formatter` | `grain` | | Dockerfile linter, validate inline bash, written in Haskell | `linter` | `dockerfile` | | Tool for writing clean and consistent HAML | `linter` | `haml` | | Formatter for hcl files | `formatter` | `hcl` | | Format Haskell programs. Inspired by the gofmt utility | `formatter` | `haskell` | | Haskell pretty printer | `formatter` | `haskell` | | Haskell source code suggestions | `linter` | `haskell` | | Hongdown is a Markdown formatter that enforces Hong Minhee's Markdown style conventions | `formatter` | `markdown` | | A html formatter | `formatter` | `html` | /htmlbeautifier) | A normaliser/beautifier for HTML that also understands embedded Ruby. Ideal for tidying up Rails templates | `formatter` | `erb`, `html`, `ruby` | | The static code analysis tool you need for your HTML | `linter` | `html` | | Formatter for hurl files | `formatter` | `hurl` | | A formatter for Imba | `formatter` | `imba` | | A language for building concurrent software with confidence | `formatter` | `inko` | | A Python utility to sort imports | `formatter` | `python` | | A formatter for Janet code | `formatter` | `janet` | | Small Clojure interpreter, linter and formatter | `formatter`, `linter` | `clojure` | | Command-line JSON processor | `formatter` | `json` | | like gofmt, but for jq | `formatter` | `jq` | | Beautifier for javascript | `formatter` | `javascript` | | JSON5 formatter that preserves contextual comments | `formatter` | `json5`, `json` | | A module to repair invalid JSON from LLMs | `linter` | `json` | | JSONA parser, linter, formatter, lsp and cli | `formatter`, `linter` | `jsona` | | A JSON parser and validator | `formatter`, `linter` | `json` | | Linter for jsonnet files | `linter` | `jsonnet` | | Formatter for automatically fixing jsonnet stylistic problems | `formatter` | `jsonnet` | | A fast command line JSON pretty printer | `formatter` | `json` | uliaformatter.jl) | An opinionated code formatter for Julia. Plot twist - the opinion is your own | `formatter` | `julia` | | Just a command runner | `formatter` | `just` | | KCL Format tool supports reformatting KCL files to the standard code style | `formatter` | `kcl` | | A formatter for kdl documents | `formatter` | `kdl` | | Reformats Kotlin KDoc comments, reflowing text and other cleanup | `formatter` | `kotlin` | | keep-sorted is a language-agnostic formatter that sorts lines between two markers in a larger file | `formatter` | | | A program that reformats Kotlin source code to comply with the common community standard for Kotlin code conventions | `formatter` | `kotlin` | | An anti-bikeshedding Kotlin linter with built-in formatter | `linter` | `kotlin` | | KubeLinter is a static analysis tool that checks Kubernetes YAML files and Helm charts to ensure the applications represented in them adhere to best practices | `linter` | `kubernetes`, `yaml` | | An opinionated .http and .rest files linter and formatter | `formatter` | `http` | | A formatter for the leptos view! macro | `formatter` | `rust` | /liquidsoap-prettier) | Prettier plugin for liquidsoap script | `formatter` | `liquidsoap` | | A tool for linting and static analysis of Lua code | `formatter` | `lua` | | Code formatter for Lua | `formatter` | `lua` | | Typecheck and lint luau files | `linter` | `luau` | | A fast Markdown linter written in Rust | `linter` | `markdown` | | Mago is a toolchain for PHP that aims to provide a set of tools to help developers write better code | `formatter`, `linter` | `php` | | Like gofmt, but for Markdown | `formatter` | `markdown` | n/markdownlint-cli2) | A fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the markdownlint library | `linter` | `markdown` | | A Node.js style checker and lint tool for Markdown/CommonMark files | `linter` | `markdown` | | An HTML linter for all markup developers | `linter` | `html` | | mbake is a Makefile formatter and linter | `formatter`, `linter` | `make` | | AST-based padding for Markdown and natural language, improving readability in multilingual documents | `formatter` | `markdown` | | CommonMark compliant Markdown formatter | `formatter` | `markdwon` | | Run mdsf inside mdsf | `formatter` | `markdown` | | Prepare your markdown for easy diff'ing! | `formatter` | `markdown` | | Meson is an open source build system meant to be both extremely fast, and, even more importantly, as user friendly as possible | `formatter` | `meson` | | A linter for MATLAB | `linter` | `matlab` | | A formatter for MATLAB | `formatter` | `matlab` | | dev tools, env vars, task runner | | | | Correct commonly misspelled English words in source files | `spell-check` | | | Code formatter for Elixir | `formatter` | `elixir` | | Formats Mojo source files | `formatter` | `mojo` | | An implementation of the meson build system in c99 | `formatter`, `linter` | `meson` | | Optional static typing for Python | `linter` | `python` | | Formatter for NASM source files | `formatter` | `assembly` | nginxbeautifier) | Format and beautify nginx config files | `formatter` | `nginx` | onfig-formatter) | nginx config file formatter/beautifier written in Python with no additional dependencies | `formatter` | `nginx` | | Better configuration for less | `formatter` | `nickel` | | Code formatter for the Nim programming language | `formatter` | `nim` | | The official formatter for Nix code | `formatter` | `nix` | | Nix code formatter for nixpkgs | `formatter` | `nix` | | CLI for HashiCorp Nomad | `formatter` | `hcl` | | An opinionated code formatter for Nim | `formatter` | `nim` | m-groovy-lint) | Lint, format and auto-fix your Groovy / Jenkinsfile / Gradle files | `formatter`, `linter` | `groovy` | | The nushell formatter | `formatter` | `nushell` | | Auto-formatter for OCaml code | `formatter` | `ocaml` | | Indentation tool for OCaml | `formatter` | `ocaml` | | Formatter for the Odin programming language | `formatter` | `odin` | | Advanced oelint | `linter` | `bitbake` | | Format Rego source files | `formatter` | `rego` | | A formatter for Haskell source code | `formatter` | `haskell` | | Oxfmt a fast JavaScript/TypeScript formatter written in Rust | `formatter` | `javascript`, `typescript` | | Oxlint is designed to catch erroneous or useless code without requiring any configurations by default | `linter` | `javascript`, `typescript` | docs/commands) | Packer is used to format HCL2 configuration files | `formatter` | `hcl` | | A formatter and linter for Pandoc markdown, Quarto, and RMarkdown | `formatter` | `markdown`, `pandoc`, `quarto`, `rmarkdown` | on-development/pasfmt) | Delphi code formatter | `formatter` | `delphi`, `pascal` | | Python Linter for performance anti patterns | `linter` | `python` | | Perl::Tidy, a source code formatter for Perl | `formatter` | `perl` | | A PostgreSQL SQL syntax beautifier | `formatter` | `sql` | | A tool to automatically fix PHP Coding Standards issues | `formatter`, `linter` | `php` | | PHP Code Beautifier and Fixer fixes violations of a defined coding standard | `formatter` | `php` | | Instant PHP quality checks from your console | `linter` | `php` | | Laravel Pint is an opinionated PHP code style fixer for minimalists | `formatter`, `linter` | `php` | | A configuration as code language with rich validation and tooling | `formatter` | `pkl` | | Prettier is an opinionated code formatter | `formatter` | `angular`, `css`,

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/hougesen/mdsf

Awesome Lists containing this project

README