markdown.style

Blueprint: drafting-table discipline for specs and plans

Blueprint borrows the visual language of an engineering drawing: a boxed title block, uppercase mono annotations, and drafting blues on cool paper. Below is a complete sample rendered in it.

Use Blueprint on my markdown Open the exported file

What does the Blueprint theme look like?

This is a complete sample report rendered in Blueprint: the exact output the editor downloads, embedded here unmodified.

Quarterly Growth Report

Written by an LLM in seconds, styled by markdown.style.

This is the markdown an AI assistant hands you: solid structure, zero design. The theme you are looking at is doing all of the visual work.

Highlights

Region Revenue Growth
EMEA 4.2M +14%
APAC 3.1M +22%
AMER 6.8M +9%

What drove the quarter

Net growth is computed per region as rate * (1 - churnShare) and rolled up weekly. The pipeline behind it:

export function netGrowth(rates: number[], churn: number[]): number {
  return rates.reduce((sum, r, i) => sum + r * (1 - (churn[i] ?? 0)), 0)
}

Numbers exclude the acquisition closed after the quarter cutoff.[1]

Full methodology lives in the reporting handbook.

  1. See the finance memo for reconciliation details. ↩︎

What does every element look like in Blueprint?

Every markdown building block, one at a time: the raw markdown on the left, that exact snippet rendered in Blueprint on the right.

Headings

Markdown

# Quarterly report
## Revenue summary
### Regional breakdown
#### North America

Blueprint

Quarterly report

Revenue summary

Regional breakdown

North America

Text

Markdown

The rollout finished on schedule, and adoption **exceeded projections** within the first week. Support tickets stayed *manageable* throughout, thanks to the `deploy.sh` script.

Blueprint

The rollout finished on schedule, and adoption exceeded projections within the first week. Support tickets stayed manageable throughout, thanks to the deploy.sh script.

Links

Markdown

Read the [full changelog](https://example.com/changelog) or check the [migration guide](https://example.com/migrate) before upgrading.

Blueprint

Read the full changelog or check the migration guide before upgrading.

Unordered list

Markdown

- Draft the proposal
- Circulate for feedback
- Ship the final version

Blueprint

  • Draft the proposal
  • Circulate for feedback
  • Ship the final version

Ordered list

Markdown

1. Clone the repository
2. Install dependencies
3. Run the test suite

Blueprint

  1. Clone the repository
  2. Install dependencies
  3. Run the test suite

Nested list

Markdown

- Frontend
  - Component library
  - Routing
- Backend
  - Database schema
  - API endpoints

Blueprint

  • Frontend
    • Component library
    • Routing
  • Backend
    • Database schema
    • API endpoints

Task list

Markdown

- [x] Write the proposal
- [x] Get sign-off from legal
- [ ] Schedule the launch

Blueprint

Blockquote

Markdown

> Ship small, ship often, and let the data tell you when to stop.

Blueprint

Ship small, ship often, and let the data tell you when to stop.

Code block

Markdown

```ts
export function total(items: number[]): number {
  return items.reduce((sum, n) => sum + n, 0)
}
```

Blueprint

export function total(items: number[]): number {
  return items.reduce((sum, n) => sum + n, 0)
}

Table

Markdown

| Quarter | Revenue | Growth |
|---------|---------|--------|
| Q1      | $2.1M   | 12%    |
| Q2      | $2.6M   | 24%    |

Blueprint

Quarter Revenue Growth
Q1 $2.1M 12%
Q2 $2.6M 24%

Footnote

Markdown

Revenue grew faster than any prior quarter.[^1]

[^1]: Figures are unaudited and subject to restatement.

Blueprint

Revenue grew faster than any prior quarter.[1]

  1. Figures are unaudited and subject to restatement. ↩︎

Horizontal rule

Markdown

The first half closed strong.

---

The second half opened even stronger.

Blueprint

The first half closed strong.

The second half opened even stronger.

Image

Markdown

![Quarterly revenue chart](/specimen-chart.svg)

Blueprint

Quarterly revenue chart

Math

Markdown

The compound growth rate is $r = (V_f/V_i)^{1/n} - 1$.

Averaged across all quarters:

$$\bar{r} = \frac{1}{n}\sum_{i=1}^{n} r_i$$

Blueprint

The compound growth rate is r=(Vf/Vi)1/n−1r = (V_f/V_i)^{1/n} - 1.

Averaged across all quarters:

rˉ=1n∑i=1nri\bar{r} = \frac{1}{n}\sum_{i=1}^{n} r_i

Mermaid diagram

Markdown

```mermaid
graph TD
  A[Draft] --> B[Review]
  B --> C[Publish]
```

Blueprint

Mermaid diagrams need a live browser to lay out, so this static gallery can't render one; try it in the editor.

Who is the Blueprint theme for?

Specs, architecture documents, and implementation plans; writing that describes something to be built and benefits from looking like it.

Which themes pair well with it?

  • Slate: Specs, status updates, PRDs, and technical summaries
  • Manual: API references, how-to guides, and README-grade documentation

Part of the Technical & Docs collection: see the rest of the category.

Browse all themes →

100% in your browser · no upload · free · no sign-up