flowmark

A Markdown auto-formatter for clean diffs and semantic line breaks.

This is a Rust port of flowmark (Python), with identical CLI and identical output. See the Python project 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 download a pre-built binary from 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 v0.6.4 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