| name | flowmark |
| description | Fast, consistent Markdown auto-formatter for typographic cleanup, normalization, and clean semantic line breaks. Use when creating, editing, or cleaning Markdown; formatting LLM-generated docs; adopting Flowmark in a repository; adding Markdown format scripts or commit hooks; or replacing Prettier or another Markdown formatter. |
| allowed-tools | Bash(flowmark:*), Bash(uvx:*), Read, Write |
Flowmark - Markdown Auto-Formatter
Fast, consistent Markdown auto-formatter.
Run it on Markdown you generate or edit so committed diffs stay small and readable.
It is conservative and safe to run on every file: it never modifies code blocks or
inline code.
Format Markdown
Format in place with all auto-formatting (typography, cleanups, semantic line breaks):
flowmark --auto FILE
flowmark --auto .
Omit --auto to preview to stdout; pipe stdin with - (e.g. cat FILE | flowmark -).
Use flowmark when it is already on PATH. Otherwise use the fast
Rust port with a version-pinned uvx runner
(never @latest):
uvx --from flowmark-rs==0.3.2 flowmark --auto FILE
The Python reference remains available when its
library API or a newer unported patch is required:
uvx --from flowmark==0.7.2 flowmark --auto FILE
Adopt Flowmark in a Repository
If this skill came from flowmark --skill, run the same runner with --install-skill
from the project root to materialize the complete bundle.
Then, for a repository-wide migration, Makefile wiring, .flowmarkignore, commit hooks,
CI policy, and disabling Prettier or other competing Markdown formatters, read
project-setup.md in full before editing.
Full Documentation
Flowmark documents itself.
Use the CLI rather than reproducing details here:
flowmark --help — every flag: --semantic, --smartquotes, --ellipses,
--width, --check, list spacing, and file discovery
(--extend-include/--extend-exclude).flowmark --docs — the full guide: configuration, file discovery, editor setup, the
Python library API, and installing this skill (flowmark --install-skill).
