Writing Basics

Methanol supports Markdown and MDX. Use Markdown for structure, and add JSX components when you want richer layouts or interactivity.

Basic Page

---
title: My Page
excerpt: Short summary used in meta tags
---

# My Page

Write your content here.

The --- block at the top is called frontmatter. See below for what it does.

Headings and TOC

Headings (##, ###, ####) are used to build the table of contents. Keep a clear hierarchy for the sidebar TOC to stay readable.

Body Text

In Markdown, your content is usually made of paragraphs:

First paragraph line 1
First paragraph line 2 (usually merges into the same paragraph)

Second paragraph
This line has two trailing spaces  
so it breaks

Blockquotes

> This is a blockquote.
>
> Put `>` on an empty line to keep a blank line inside the same quote.
> Multiple quoted lines become one quote block.

> A blank line between `>` blocks creates a new quote block.

This renders as:

This is a blockquote.

Put > on an empty line to keep a blank line inside the same quote. Multiple quoted lines become one quote block.

A blank line between > blocks creates a new quote block.

Code Blocks

Use fenced code blocks with language identifiers:

```js
export const title = 'Hello'
```

This renders as:

export const title = 'Hello'

Learn Markdown

This guide focuses on Methanol + MDX. For a fuller Markdown syntax reference, see:

Frontmatter Tips

Common fields for authors:

Full list: Frontmatter reference