# Zuwiki

## Markdown Basics

> Category: Editor Guide

---

## Pages

- [Welcome to Zuwiki](https://docs.zuwiki.com/welcome-to-zuwiki)

### Getting Started

- [Create Your First Wiki](https://docs.zuwiki.com/getting-started/create-your-first-wiki)
- [Organize with Categories](https://docs.zuwiki.com/getting-started/organize-with-categories)
- [Publish Your First Page](https://docs.zuwiki.com/getting-started/publish-your-first-page)

### Core Concepts

- [Wikis, Categories, and Pages](https://docs.zuwiki.com/core-concepts/wikis-categories-and-pages)
- [Page Lifecycle](https://docs.zuwiki.com/core-concepts/page-lifecycle)
- [Page History and Restore](https://docs.zuwiki.com/core-concepts/page-history-and-restore)

### Access & Sharing

- [Public vs Internal Wikis](https://docs.zuwiki.com/access-sharing/public-vs-internal-wikis)
- [Visibility for Public Wikis](https://docs.zuwiki.com/access-sharing/visibility-and-access)
- [Share Links](https://docs.zuwiki.com/access-sharing/share-links)
- [Access Grants](https://docs.zuwiki.com/access-sharing/access-grants)
- [Classification and Sensitivity](https://docs.zuwiki.com/access-sharing/classification-and-sensitivity)

### Editor Guide

- [Markdown Basics](https://docs.zuwiki.com/editor-guide/markdown-basics)
- [Linking Between Pages](https://docs.zuwiki.com/editor-guide/linking-between-pages)
- [Icons and Visual Touches](https://docs.zuwiki.com/editor-guide/icons-and-visual-touches)
- [Rich Content Blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI Pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [Plans and Limits](https://docs.zuwiki.com/plans-account/plans-and-limits)
- [Custom Domain](https://docs.zuwiki.com/plans-account/custom-domain)
- [Zuwiki for Open Source](https://docs.zuwiki.com/plans-account/zuwiki-for-open-source)

### Integrations

- [MCP Server](https://docs.zuwiki.com/integrations/mcp-server)

---

# Markdown Basics

Zuwiki stores every page as Markdown. The editor is WYSIWYG, but the underlying file is plain Markdown, which means pages travel cleanly through the API, the MCP server, and any external tool that understands Markdown.

## Headings

Use a single `#` for the page title and `##` for the next level. Skipping levels confuses readers and screen readers alike.

```markdown
# Page Title
## Section
### Subsection
```

## Emphasis

```markdown
**bold for strong emphasis**
*italics for light emphasis*
`monospace for code, paths, identifiers`
```

Avoid ALL CAPS for emphasis. Bold is louder and easier to skim.

## Lists

Use bullet lists for unordered items and numbered lists when the order matters.

```markdown
- First
- Second
- Third

1. Step one
2. Step two
3. Step three
```

## Code blocks

Always add a language hint so syntax highlighting works.

````markdown
```ts
function greet(name: string): string {
  return `Hello, ${name}`;
}
```
````

## Tables

Tables work for small comparisons. For anything beyond five rows, prefer a list or split the data into multiple sections.

```markdown
| Field | Type | Notes |
| --- | --- | --- |
| id | string | UUID |
| title | string | shown in sidebar |
```

## Quotes and callouts

Use blockquotes for direct quotes or to highlight a single important sentence.

```markdown
> Drafts are visible to editors but hidden from regular readers.
```

## Beyond Markdown

The editor also offers richer blocks, such as callouts, steps, and tabs, that go past plain Markdown while still living in the page. See [Rich Content Blocks](/editor-guide/rich-content-blocks).