Dprint

dprint

The formatter for configuration and markup files (JSON, Markdown, TOML, YAML); dprint formats only, while Python formatting and linting live in [ruff](../python-stack/references/ruff.md).

Configuration

dprint searches the current directory upward for dprint.json or dprint.jsonc and falls back to the global config (DPRINT_CONFIG_DIR) only when nothing is found. Global fallback can prompt before fmt; use a local, version-pinned configuration for non-interactive project gates.

1. Copy (default): copy a known-good dprint.json into the project root; it is self-contained and version-pinned. The first run downloads uncached plugins; later runs use dprint's local cache. Bump plugin versions per repository.
2. Extends (DRY): set "extends" to a single source of truth, a local path or a commit-pinned URL such as "https://raw.githubusercontent.com/fmind/dot//dprint.json"; override rules or add plugins locally.

Commands

dprint fmt --allow-no-files   # format:dprint — the hook appends {staged_files}; the flag keeps an empty list from exiting 14
dprint check                  # check:format — non-zero exit on drift
dprint add            # add and pin a plugin version

Mise Tasks

[tasks."format:dprint"]
description = "Format JSON, Markdown, TOML, YAML (dprint)"
run = "dprint fmt --allow-no-files" # mise appends the hook's {staged_files}

[tasks."check:format"]
description = "Check config and markup formatting (dprint)"
run = "dprint check"

Gotchas

• Plugin references: prefer the npm: form (npm:@dprint/markdown@0.24.0, npm:dprint-plugin-yaml@0.6.0) over https://plugins.dprint.dev/...wasm URLs; both resolve, and the npm form makes the current version one npm view version away.
• Plugin order is precedence: the plugins array order decides which plugin claims a file; keep specialized plugins before generic ones.
• Embedded code blocks: the Markdown plugin formats fenced JSON, TOML, and YAML only when those plugins are loaded too.
• Staged vs whole-tree: format:dprint takes {staged_files} from the hook and restages fixes; check:format always runs on the whole tree.

Documentation

• dprint · Configuration · CLI
• Releases: dprint
• Companion skills: [mise](../mise/SKILL.md) (task vocabulary), [lefthook](../github-actions/references/lefthook.md) (the pre-commit hook that calls format:dprint).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: fmind
• Source: fmind/dot
• License: MIT
• Homepage: https://fmind.dev

Install and usage instructions live in the source repository linked above.