preface/README.mdpublic

Your code deserves a README people actually read.

Dump your project in (manifests, file trees, half-written notes) and get back a structured README. Then shape it with a live GitHub-accurate preview, a badge builder, and five very different templates.

TypeScript71.4%CSS19.2%JavaScript9.4%

Every section toggleable, in any template

LessMore
preface/README.md
Markdown
1
Preview

Everything the first draft needs

Preface does the mechanical work so the only thing left is the part that needs you.

6 features
parser

Dump in, README out

Paste a package.json, a file tree, or a pile of source files. Preface parses manifests, detects your stack, and pulls out scripts, environment variables and structure.

editor

Split-screen editing

Markdown on the left, a GitHub-accurate preview on the right, in both light and dark theme. Form and markdown stay in sync until you take over.

import

Import from a repo

Paste a GitHub URL. Description, license, language breakdown, topics and root manifests come back filled in.

badges

Badge builder

Eighty shields.io badges across languages, frameworks, databases and infrastructure, plus live star, issue and last-commit badges.

templates

Eight distinct styles

The same content rendered as a minimal library README, a conventional OSS layout, a loud showcase page, a dense reference doc, a CLI page, an Action, a monorepo, or a profile README.

offline

Works with no API key

The analyzer, editor, preview, badges and templates all run in your browser. No account, no key, no upload.

One spec, every template

Switching template never loses content. The same structured data is re-rendered with different chrome.

8 templates

How it works

Four steps, about thirty seconds.

4 jobs
  1. 1

    Dump or import

    Paste project content, or pull straight from a GitHub URL.

    $preface import vercel/next.js
  2. 2

    Analyze

    Manifests, scripts, env vars and structure, parsed in an instant.

    $analyze --local
  3. 3

    Shape it

    Toggle sections, pick badges, switch template. Preview updates live.

    $template set showcase
  4. 4

    Ship it

    Copy to clipboard or download README.md. Nothing to sign up for.

    $download README.md
README.md · 0 bytes

Stop shipping a README that just says the project name.

No account, no upload, nothing to configure. Open the builder and paste something.

Open the builder