什么是Flowmark？

Flowmark 是一款 Markdown 自动格式化工具，编写为 在 Python 中，带有自动同步 Rust移植版，专为更好的大型语言模型设计 工作流程、清理git差异以及灵活使用CLI、IDE或作为 图书馆。

随着AI工具越来越多地生成Markdown、一致且适合差异的格式 变得至关重要。 它改善了协作编辑和大型语言模型的工作流程，尤其是在提交时 文档到git仓库。

对于CLI自动格式化，Python和Rust构建输出相同：Rust port 是一个快速的单一原生二进制文件，而 Python 版本是参考，是 有时会提前更新最新功能。 选择适合你环境的;对于重度或延迟敏感的格式，请选择 锈蚀二元论。

快速启动

Python 和 Rust 版本最好安装于 呃。

与[[T0]一起奔跑]

一次性使用无需安装：

作为全局CLI安装

可以跑flowmark --help、flowmark --docs或flowmark --skill获取更多内容。

使用任何编码代理

把这条指令交给你的经纪人：

设置了Flowmark，保持该项目的Markdown自动格式化。

flowmark

What Is Flowmark?

Flowmark is a Markdown auto-formatter, written in Python with an auto-synced Rust port, designed for better LLM workflows, clean git diffs, and flexible use from CLI, from IDEs, or as a library.

With AI tools increasingly producing Markdown, consistent and diff-friendly formatting has become essential. It improves collaborative editing and LLM workflows, especially when committing documents to git repositories.

For CLI auto-formatting, the Python and Rust builds produce identical output: the Rust port is a fast single native binary, while the Python version is the reference and is sometimes ahead on the newest features. Pick whichever fits your environment; for heavy or latency-sensitive formatting, choose the Rust binary.

Quick Start

Both Python and Rust versions are best installed with uv.

Run With uvx

No install needed for one-off usage:

uvx --from flowmark-rs==0.4.0 flowmark --help
uvx --from flowmark-rs==0.4.0 flowmark --auto somefile.md
uvx --from flowmark==0.8.0 flowmark --help  # Python reference

Install as a Global CLI

uv tool install flowmark-rs==0.4.0  # Native Rust CLI
flowmark --auto somefile.md                         # One file
flowmark --auto .                                   # Whole tree

Run flowmark --help, flowmark --docs, or flowmark --skill for more.

Set Up with Any Coding Agent

Hand your agent this one instruction:

Set up Flowmark to keep this project’s Markdown auto-formatted. Install the Flowmark skill with npx skills add jlevy/flowmark@flowmark and follow it.

Or install the skill into .agents/, .claude/, and AGENTS.md directly:

uvx --from flowmark-rs==0.4.0 flowmark --install-skill

See How to Install the Skill for the available surfaces.

For consistency across users and supply chain security, it’s recommended to pin the version when installing within a skill or project build.

Why Another Markdown Auto-Formatter?

Flowmark supports both CommonMark and