DESIGN.mdA
DESIGN.md from markrahq/markra is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add markrahq/markra/DESIGN.md@alphaPins alpha in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- markrahq/markra
- Path
DESIGN.md- Versions recorded
- 4
- Latest version
- alpha, committed Sep 22, 2026
- First version recorded
- May 16, 2026
- Size
- 15,177 bytes
- Repository stars
- 951
- License
- AGPL-3.0
Local-first WYSIWYG Markdown desktop editor with quiet writing surfaces, native AI review flows, and a restrained ink-black interaction system.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Markra Design System ## Overview Markra should feel like a native writing instrument: calm, fast, local, and precise. The interface gives most of its attention to the Markdown document, while file navigation, AI controls, settings, and export tools stay quiet until needed. The default visual language is light, neutral, and editorial. It avoids decorative branding, heavy panels, and marketing-style composition. The primary ink-black is reserved for interaction, focus, active states, and AI/editor affordances; it should not flood the workspace. The product serves writers, engineers, researchers, and documentation-heavy teams. Screens should feel trustworthy for long-form reading and repeated editing, with enough density for desktop productivity and enough air around the document to keep the writing surface comfortable. ## Colors The palette is based on clean neutrals and one restrained ink-black accent. - **Primary (#1A1C1E):** A deep ink-black interaction color. Use for primary actions, focus rings, active toggles, drop indicators, selected status, links, and AI review controls. …
Read the whole file at its exact version.
How to install
mdr add markrahq/markra/DESIGN.md@sha256:7baf6a3ceb299376The line at the top of this page pins the label alpha, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_mia22deckgxdwyfh)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between May 16, 2026 and Sep 22, 2026, about one every 43 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| alpha latest | 2026-09-22 | cd73445 | 15,177 B | A | view · diff |
| alpha | 2026-07-26 | b0a9b96 | 14,225 B | A | view · diff |
| alpha | 2026-07-25 | e55b596 | 14,192 B | A | view · diff |
| alpha | 2026-05-16 | a698388 | 14,091 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (15177 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
markrahq/markra · 951 stars · license AGPL-3.0 · pushed 2026-11-04 · branch v2
API
GET https://markdownregistry.com/api/v1/artifacts/art_mia22deckgxdwyfh GET https://markdownregistry.com/api/v1/resolve?ref=markrahq/markra/DESIGN.md GET https://markdownregistry.com/api/v1/blob/7baf6a3ceb2993762ea83fc4ee0f8368eb4ff1d33b32501d95ccdfae922669a2
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: what DESIGN.md is and how agents use it · which agent file does what.