# 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)

### 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 images](https://docs.zuwiki.com/editor-guide/icons-and-images)
- [Rich content blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

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

Every page is stored as plain Markdown, even though the editor is visual. That is why pages travel cleanly through the API, the [MCP server](/integrations/mcp-server) and any other tool that understands Markdown.

## The syntax you will use most

````markdown
# Page title
## Section
### Subsection

**bold**, *italic* and `code`

- a bullet list
- with items

1. a numbered list
2. for steps in order

> A quote, or one sentence worth pulling out

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

| Field | Type |
| --- | --- |
| id | string |
````

## A few habits that help

Use one `#` for the page title and `##` for the sections below it. Skipping levels confuses readers and screen readers alike.

Always give a code block a language, otherwise it gets no syntax highlighting.

Use tables for small comparisons. Past five rows or so, a list or a few sections is easier to read. Bold is enough for emphasis, there is no need to shout in capitals.

## Beyond Markdown

The editor also has callouts, steps, tabs and more. They are covered in [Rich content blocks](/editor-guide/rich-content-blocks).
