From blank page to shipped wiki in under 5 minutes.
A single-page quickstart. Open a page, write something, link it to another page, share with your team. The deeper references (shortcuts, integrations, API) are linked from the sidebar.
Your first page
Sign in, hit + New page. Title at the top, content below. Start typing. That’s the entire flow.
Pages are saved continuously — you’ll never lose a paragraph to a missed Cmd-S. Version history is kept indefinitely on Team and Org plans.
Building the tree
Pages live in a tree. Drag a page to nest it under another. Folders are just pages with sub-pages. There’s no separate “folder” type.
The default is to organise around topics, not date or author. Engineering > RFCs > 042 reads better than “Aino’s notes — May 14”.
Permissions
Set permissions where they make sense, let them inherit down the tree. Default: workspace can read, the relevant team can edit. Override on specific pages if needed.
- Workspace — anyone in your workspace.
- Group — one of your groups (Engineering, Product, etc.).
- Specific people — list of named users.
- Public — share by URL, optionally domain-restricted.
Sharing
Click Share in the top-right of any page. The dialog shows the current effective permissions (including anything inherited from a parent). Add or override here. Guests — people outside your workspace — are free on every plan.
Markdown shortcuts
The editor recognises markdown as you type. ## becomes h2, - [ ] becomes a checklist, > becomes a callout. You don’t need to learn a separate syntax — the markdown you know works.
Slash command
Type / anywhere to bring up the block menu. Type to filter. /code for a code block, /checklist for a checklist, /callout for a callout, /embed for an embed.
Links & backlinks
Type [[ to start an internal link. The autocomplete searches across every page in your workspace as you type. Once linked, both sides know about it — the linked page shows a “Linked from” entry.
Renaming a page rewrites every link to it across the wiki.
Blocks
- Paragraph, heading (H1–H4), quote, callout
- List (bulleted, numbered, checklist)
- Code block with syntax highlighting (80+ languages)
- Table with sortable columns
- Toggle (collapsible section)
- Embed (Figma, Loom, Google Doc, YouTube, OakWiki page)
- File attachment
We don’t do every block type. The list is intentionally short. If something specific is missing, email us.
Keyboard shortcuts
The most-used. Full list in the help menu (?).
Import & export
- Notion — drop a workspace export; tree, formatting, internal links all come across.
- Confluence — space export (XML); tree comes across, attachments transfer.
- Markdown — bulk import a folder of
.mdfiles; export anything back to Markdown at any time. - JSON — full workspace export for backup or programmatic processing.
- HTML — export for printing or for handing off to a stakeholder who lives outside the wiki.
API & webhooks
Read-only page API on Team; read/write on Org. Webhooks for page-created / page-updated / member-added / comment-posted events.
The page content itself is exportable as JSON; re-importable into a new workspace. Round-tripping preserves structure, comments, and history metadata.
Getting help
Email support@oakwiki.com. For now we don’t run a community Slack — we found support quality is higher when conversations stay in writing.