`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 regenerate its task links:

cargo bake --regenerate
cargo add --manifest-path bake/Cargo.toml bake-markdown
cargo bake --regenerate

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.

Releasing

Prepare a release with cargo bake cargo:version:patch (or minor, major, or bump --version X.Y.Z), then run cargo bake cargo:release and open a pull request. After review and merge, GitHub Actions publishes the release when the configured crates-io environment approves it. Follow the shared Releasing skill for the standard process.

Releases

See releases.md for the full release history.

v0.3.2

Document the shared release process.

v0.3.1

Resolve development task dependencies to the current checkout.
Adopt socketry-project 0.3.7 for shared project tasks and Markdown normalization.
Require the aggregate test and coverage result for pull request merges.
Avoid duplicate ordinary test runs in pull request publishing checks.

v0.3.0

Normalize unordered Markdown lists with hyphen markers.

Contributing

Please open an issue or pull request on GitHub.

Agent Context

Run cargo bake agent:context:install to install shared context and skills. Read .agents/context/index.md to find relevant guides, follow agents.md if present, and apply skills under .agents/skills/. The installer preserves repository-owned agents.md; it does not create or regenerate that file.

bake-markdown 0.3.2