bake-markdown

Markdown normalization for Bake projects. It joins soft source line breaks in Markdown files while preserving explicit hard breaks, code, and block boundaries.

Motivation

Hard-wrapped paragraphs are difficult to edit consistently. This crate uses the socketry-markdown syntax tree and serializer so normalization follows Markdown structure instead of changing lines with regular expressions.

Usage

Add the crate to the project's private bake/ package and link its tasks:

[dependencies]
bake-markdown = "0.1"

use bake_markdown as _;

Normalize one or more files relative to the project root:

cargo bake markdown:normalize readme.md context/guide.md

Rust callers can use bake_markdown::normalize_document directly.

Releases

See releases.md for the full release history.

v0.2.0

• Accept Markdown paths as positional arguments to markdown:normalize.

v0.1.0

• Add the markdown:normalize task to join soft source line breaks in Markdown files while preserving explicit hard breaks, code, and block boundaries.

See Also

socketry-markdown provides the parser and serializer used by this crate.

Contributing

Please open an issue or pull request on GitHub.

Agent Context

Before contributing, read .agents/context/index.md and the relevant context files it links. If the index is missing or out of date, run cargo bake agent:context:install to install context from dependencies and refresh the index.