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 # one file
flowmark --auto . # whole tree (respects .gitignore and .flowmarkignore)
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.4.0 flowmark --auto FILE
The Python reference remains available when its library API or a newer unported patch is required:
uvx --from flowmark==0.8.0 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).