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.3"

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.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.

v0.2.0

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

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

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.