ACE - Support Markdown 

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

<a href="https://rubygems.org/gems/ace-support-markdown"><img alt="Gem Version" src="https://img.shields.io/gem/v/ace-support-markdown.svg" /></a>
<a href="https://www.ruby-lang.org"><img alt="Ruby" src="https://img.shields.io/badge/Ruby-3.2+-CC342D?logo=ruby" /></a>
<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg" /></a>

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