markdown.style

Manual: reference styling with man-page bones

Manual sets your markdown like documentation that has shipped with software for decades: uppercase section heads, a serif reading measure, and code that stands proud of the prose. Below is a complete sample rendered in it.

Use Manual on my markdown Open the exported file

What does the Manual theme look like?

This is a complete sample report rendered in Manual: 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 Manual?

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

Headings

Markdown

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

Manual

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.

Manual

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.

Manual

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

Unordered list

Markdown

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

Manual

  • 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

Manual

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

Nested list

Markdown

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

Manual

  • 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

Manual

Blockquote

Markdown

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

Manual

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)
}
```

Manual

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%    |

Manual

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.

Manual

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.

Manual

The first half closed strong.

The second half opened even stronger.

Image

Markdown

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

Manual

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$$

Manual

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]
```

Manual

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 Manual theme for?

API references, how-to guides, and README-grade documentation; anything a reader consults rather than reads cover to cover.

Which themes pair well with it?

  • Slate: Specs, status updates, PRDs, and technical summaries
  • Terminal: Runbooks, CLI documentation, and incident notes

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