flowmark

Flowmark is a Markdown auto-formatter designed for better LLM workflows, clean git diffs, and flexible use from CLI, from IDEs, or as a library.

Rust Port of Python Flowmark

This is an auto-synced Rust port of the Python version. The original Python version is well tested and this port aims for identical CLI usage and formatting behavior.

Last sync: 2026-02-19 against Python v0.6.4

More Info

See the Python version for full documentation, including features, CLI reference, configuration, IDE setup, and agent use.

Why the Rust version?

• Single binary, no runtime — cargo install or download a binary. No Python environment needed.
• Fast — useful for large repos or CI pipelines.
• Library crate — embed formatting in Rust toolchains via docs.rs/flowmark.

Installation

Install from crates.io:

cargo install flowmark

Or install a pre-built binary with cargo-binstall:

cargo binstall flowmark

Pre-built binaries for Linux (x86_64, ARM64), macOS (x86_64, ARM64), and Windows (x86_64, ARM64) are available on GitHub Releases.

Usage

# Format a file in place
flowmark --auto myfile.md

# Format all markdown in current directory
flowmark --auto .

# Read from stdin, write to stdout
cat myfile.md | flowmark -

Library usage

use flowmark::FormatOptions;

let opts = FormatOptions::default();
let formatted = opts.reformat_text("# Hello\n\nSome text.");
assert_eq!(formatted, "# Hello\n\nSome text.\n");

See docs.rs/flowmark for full API documentation.

Port Status

This crate tracks flowmark with full feature parity:

• Identical formatting output for all supported Markdown constructs (CommonMark + GFM: tables, footnotes, alerts, strikethrough, task lists, math)
• Identical CLI flags, configuration files, and file discovery
• 430 tests (0 ignored, 0 failures), including 31 cross-language parity tests
• All 292 Python tests have verified Rust counterparts — see the port coverage mapping for the full test-by-test mapping, which is CI-enforced

The port was created using the rust-porting-playbook.

Documentation

License

MIT