ACE - Support Markdown

Safe, composable markdown editing tools for ACE libraries and docs. ACE Logo

Gem Version Ruby License: MIT

Works with: Claude Code, Codex CLI, OpenCode, Gemini CLI, pi-agent, and more.

ace-support-markdown provides atomic document editing with frontmatter (YAML metadata blocks at the top of markdown files) and section-level updates while preserving document integrity. It is the shared editing layer that packages like ace-task and ace-docs depend on for safe, repeatable content mutations.

Use Cases

Safely update task and docs content - use frontmatter and section editing primitives to apply metadata and content changes without risking accidental corruption during automated or agent-driven edits.

Generate documents programmatically - build reproducible markdown output with builder-like APIs used by ace-task for spec files and ace-docs for generated documentation.

Preserve history during edits - maintain backup and rollback safety for write-heavy operations so that tools like ace-task can update specs confidently in batch workflows.

Testing Contract

This package now follows the batch-2 deterministic fast + feat model.

  • ace-test ace-support-markdown runs the default deterministic fast loop (test/fast/).
  • ace-test ace-support-markdown feat runs deterministic feature coverage (test/feat/).
  • ace-test ace-support-markdown all runs the package contract end-to-end for deterministic layers.

The package does not own a test/e2e/ surface in this migration slice.

Part of ACE