Codex skill / Markdown → HTML

Your Markdown deserves a reading experience.

Turn dense notes, briefs, and reports into polished web documents people can actually read—and share with one link.

project-brief.mdsource

# Project Atlas

## Make every project decision
easy to find

**Status:** Ready for review

Our project decisions are scattered
across chat, meetings, and documents.

## Decision

Adopt one shared decision record for
work that affects more than one team.

## Rollout

1. Week 1 — Shape
2. Week 2 — Pilot
3. Week 3 — Learn

1Portable HTML file

2Verified viewports

0Required frameworks

∞Ways to share

The same meaning, authored for readers

Source on the left. Story on the right.

Render HTML preserves the source while giving its hierarchy, evidence, and decisions a visual form.

Raw MarkdownWriting surface

# Project Atlas

## Make every project decision easy to find

**Owner:** Product Operations
**Status:** Ready for review

Our project decisions are scattered across chat, meetings, and documents.

## Decision

Adopt one shared decision record for work that affects more than one team.

## Why now

- Context depends on memory
- Old assumptions linger

Rendered HTMLReading surface

Project Atlas · Ready for review

Make every project decision easy to find.

A lightweight, searchable record that gives every cross-team decision an owner, its context, and a moment to review the assumptions behind it.

Decision

Adopt one shared record for work that affects more than one team.

01 · Shape

Agree the five required fields.

02 · Pilot

Use it on three active projects.

03 · Learn

Remove anything readers do not need.

A disciplined rendering workflow

Designed, not converted.

Understand

Read the full source, find its audience and narrative arc, and preserve the claims that matter.

Author

Choose a fitting document mode and build a semantic, self-contained, responsive page.

Verify

Inspect desktop and mobile screenshots, test interactions, and catch overflow or accessibility issues.

Open source · MIT

Give your next `.md` file a front door.

Install the skill, point Codex at your source, and ask for a page you can share. Open a real deployed example ↗

Use $render-html to turn this Markdown into a shareable page.