Markdown

Petit supports standard markdown with GitHub Flavored Markdown extensions. All markdown files are processed through a remark/rehype pipeline with Shiki syntax highlighting.

GitHub Flavored Markdown

Tables, strikethrough, task lists, and autolinks are supported via remark-gfm.

Headings

Headings automatically get id attributes and anchor links. They also appear in the table of contents sidebar when toc is enabled in your config.

## Second level
### Third level
#### Fourth level

Click any heading to copy its link to the clipboard. A brief "Link copied!" message confirms the action.

Code blocks

All code blocks get syntax highlighting via Shiki and a copy button on hover. Specify the language after the opening fence:

function greet(name: string): string {
  return `Hello, ${name}!`
}

Add a filename after the language to show a header bar:

import { defineConfig } from "@ephem-sh/petit"

export default defineConfig({
  title: "My Docs",
})

Math

Inline math uses single dollar signs: $E = mc^2$ renders as $E = mc^2$. Block math uses double dollar signs:

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

Powered by KaTeX. Supports all standard LaTeX math syntax.

Lists

Both ordered and unordered lists work as expected:

• First item
• Second item
  • Nested item
  • Another nested item
• Third item

1. First step
2. Second step
3. Third step

Task lists are also supported:

• Completed task
• Pending task

Blockquotes

Use blockquotes for callouts or notes:

Note: This is an important piece of information that readers should pay attention to.

Tables

Standard markdown tables with alignment:

Images

Reference images with ./media/ paths in your markdown:

![Alt text](./media/screenshot.png)

Petit rewrites these paths and serves files from your media directory. See the media reference for setup, theme-aware images, favicons, and optimization.

Components

Petit extends markdown with custom components through special code fences. These render as interactive HTML elements: