MarkBack

Appearance

MarkBackCompact labels for content + feedback

A compact, lintable format and toolchain for pairing content with single-line feedback. Inline, compact, and sidecar modes with sweep-capable coverage tracking.

Get Started
Format Spec
GitHub
PyPI
npm
MarkBack

Format-First

Records are easy to read, easy to lint, and stay stable under diff. V2 adds tags and sweep patterns for coverage tracking.

Storage Flexibility

Inline content, compact one-liners, and sidecar files. All produce the same logical record structure.

Tooling Included

CLI, Python, and Node.js APIs for parsing, linting, and normalization.

What MarkBack Is ​

MarkBack is a compact, human-writable format and toolchain for labeling content with feedback in a single, lintable line. It keeps raw content and evaluation notes together so you can iterate prompts, train evaluators, and track revisions without inventing a custom schema.

Quick Example ​

mb
%markback 2

@id prompt-001
@tag training

# API Design Task

Create an endpoint that:

- **GET** `/users/{id}`
- Returns JSON with `name`, `email`
- Handle 404 for missing users
<<< approved; clarity=high; needs=error examples

The content (Markdown) stays readable. The <<< line captures feedback. Try it live →

What Problem It Solves ​

Prompt iteration usually scatters content, labels, and reviewer notes across JSON, spreadsheets, and ad-hoc scripts. MarkBack standardizes that feedback loop in a text format that works in Git, can be linted, and scales from a single prompt to thousands of records.

Conceptual Flow ​

content + feedback  ->  MarkBack records  ->  lint / normalize  ->  prompt iteration