# Folio > Folio is an open-source (MIT) Confluence and Notion alternative: a self-hosted team wiki in Git with live editing, tables, AI agents and public sites. This site, https://foliowiki.online, is the public website of Folio: install guides, AI-tool integrations over MCP, and comparisons with other wikis. The product and its documentation live in the GitHub repository. ## Overview - [Folio home page](https://foliowiki.online/): Folio is an open-source (MIT) Confluence and Notion alternative: a self-hosted team wiki in Git with live editing, tables, AI agents and public sites. - [Acknowledgments](https://foliowiki.online/acknowledgments/): Folio is one person's product, built with AI coding agents. Several people around it helped it take shape. ## Install - [Install Folio](https://foliowiki.online/install/): Install Folio on a Linux server with one command, or on Coolify, Railway, Render, DigitalOcean, Dokploy, CapRover, Portainer or Fly.io. Sizing and backups. - [Install Folio on a Linux server](https://foliowiki.online/install/vps/): Install Folio on any Linux server with Docker using one script: generated secrets, optional automatic HTTPS with Caddy, update and backup commands. - [Install Folio on Coolify](https://foliowiki.online/install/coolify/): Install Folio on Coolify v4 by pasting one Docker Compose file. Coolify generates the secrets and adds the domain and HTTPS. - [Install Folio on Railway](https://foliowiki.online/install/railway/): Run Folio on Railway with managed PostgreSQL and Redis, a volume for the Git repositories and a generated HTTPS domain. Manual steps and variables. - [Install Folio on Render](https://foliowiki.online/install/render/): Install Folio on Render from one Blueprint: the app, PostgreSQL, Key Value and a persistent disk. Needs a paid plan because the free plan has no disk. - [Install Folio on DigitalOcean](https://foliowiki.online/install/digitalocean/): Run Folio on a DigitalOcean Droplet with one cloud-init script. App Platform cannot run Folio because it has no persistent volumes. - [Install Folio on Dokploy](https://foliowiki.online/install/dokploy/): Install Folio on Dokploy with a Docker Compose file and three environment variables, or with the template.toml format. - [Install Folio on CapRover](https://foliowiki.online/install/caprover/): Install Folio on CapRover with a One-Click App template: Folio, PostgreSQL and Redis, two persistent volumes and generated secrets. - [Install Folio on Easypanel](https://foliowiki.online/install/easypanel/): Install Folio on Easypanel by creating Postgres, Redis and an app service, or from the template files. Environment variables and volume mount included. - [Install Folio on Portainer](https://foliowiki.online/install/portainer/): Install Folio on a Docker host managed by Portainer: paste one stack file, set PUBLIC_URL and a database password, and deploy. - [Install Folio on Fly.io](https://foliowiki.online/install/fly/): Run Folio on Fly.io as one machine with one volume and a PostgreSQL database. A manual recipe, not a one-click, with the costs and limits stated. ## Integrations - [Connect your AI tools to Folio](https://foliowiki.online/integrations/): Connect Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, n8n and Open WebUI to a Folio wiki over MCP. Setup steps, copyable configs and a public demo. - [Connect Claude to Folio](https://foliowiki.online/integrations/claude/): Add Folio to claude.ai or Claude Desktop as a custom connector. Sign in with OAuth, pick read or write, ask Claude about your wiki or have it write pages. - [Connect ChatGPT to Folio](https://foliowiki.online/integrations/chatgpt/): Add Folio to ChatGPT as a custom MCP server with OAuth. Ask ChatGPT about your wiki, run deep research over it, and approve its writes. - [Connect Claude Code to Folio](https://foliowiki.online/integrations/claude-code/): Give Claude Code your team wiki. One claude mcp add command with a token, a shared .mcp.json, or OAuth. Read runbooks, write release notes, update tables. - [Connect Cursor to Folio](https://foliowiki.online/integrations/cursor/): Add Folio to Cursor as an MCP server: mcp.json with an environment variable, plus a rule so the agent reads your team's conventions first. - [Connect VS Code and Copilot to Folio](https://foliowiki.online/integrations/vscode/): Add Folio to VS Code as an MCP server for GitHub Copilot chat. A short mcp.json that prompts for the token, so it never lands in your repository. - [Connect Codex to Folio](https://foliowiki.online/integrations/codex/): Add Folio to Codex CLI, the ChatGPT desktop app or the IDE extension. One config.toml entry, with the token read from an environment variable. - [Connect n8n to Folio](https://foliowiki.online/integrations/n8n/): Use Folio from n8n with the MCP Client Tool node and a Bearer token. Let an AI agent answer from your wiki, or let workflows add table rows and pages. - [Connect Open WebUI to Folio](https://foliowiki.online/integrations/open-webui/): Connect Open WebUI to Folio over native MCP with a read-only Bearer token. Ask your wiki from the chat window you already use, with links to the pages. ## Free tools - [Free tools for docs and diagrams](https://foliowiki.online/tools/): Free tools that run in your browser: convert Confluence pages to Markdown and draw Mermaid diagrams with live preview. Nothing is uploaded. - [Confluence to Markdown converter](https://foliowiki.online/tools/confluence-to-markdown/): Convert Confluence pages to Markdown in your browser: paste storage format or HTML. Plus how to export a whole Confluence space to Markdown with hierarchy. - [Mermaid live editor](https://foliowiki.online/tools/mermaid-editor/): Free online Mermaid editor: draw flowchart, Gantt and ER diagrams by clicking or in code, then export Mermaid to PNG or SVG. Runs in your browser. ## Templates - [Free document templates in Markdown](https://foliowiki.online/templates/): Thirteen free templates in plain Markdown: PRD, design doc, runbook, release notes, postmortem, SOP, handbook and more. Copy, download, or see an example. - [Meeting Notes Template (Markdown)](https://foliowiki.online/templates/meeting-notes/): Free meeting notes template in plain Markdown: decisions first, action items with one owner and a date. Copy it or download the .md file. - [SOP Template (Standard Operating Procedure) in Markdown](https://foliowiki.online/templates/sop/): Free SOP template in plain Markdown: purpose, scope, roles, numbered steps with expected results, exceptions and a review date. Copy or download. - [PRD Template (Product Requirements Document) in Markdown](https://foliowiki.online/templates/prd/): What goes into a PRD, a free Markdown PRD template and a filled example, plus how to write a requirements document an AI agent can read. Copy or download. - [One-on-One Meeting Template (Markdown)](https://foliowiki.online/templates/one-on-one/): A shared running document for 1:1s in plain Markdown: their topics first, feedback both ways, growth, and action items. Copy or download. - [Release Notes Template (Markdown)](https://foliowiki.online/templates/release-notes/): Free release notes template in plain Markdown with a filled example: highlights, new, fixed, breaking changes and upgrade steps. Copy or download. - [Employee Onboarding Checklist Template (Markdown)](https://foliowiki.online/templates/onboarding-checklist/): Free onboarding checklist in plain Markdown: before day one, first week, 30-60-90 days, with an owner for every task. Copy it or download the .md. - [Runbook Template (Markdown) for On-Call and Operations](https://foliowiki.online/templates/runbook/): Free runbook template in Markdown with a filled example, and runbook vs playbook explained: triage, commands, rollback, escalation. Copy or download. - [Incident Postmortem Template (Markdown)](https://foliowiki.online/templates/postmortem/): Free blameless incident postmortem template in plain Markdown: impact, UTC timeline, root cause, what went well, action items with owners. - [How-To Guide Template (Markdown) for Documentation](https://foliowiki.online/templates/how-to-guide/): Free how-to guide template in plain Markdown: prerequisites, one-action steps with expected results, verification, fixes and a review checklist. - [API Reference Template (Markdown) for One Endpoint](https://foliowiki.online/templates/api-reference/): Free API documentation template in plain Markdown: auth, parameters, request and response examples, error table, changelog and a review checklist. - [Troubleshooting Guide Template (Markdown)](https://foliowiki.online/templates/troubleshooting-guide/): Free troubleshooting guide template in plain Markdown: exact symptoms, a diagnosis flowchart, causes with fixes, what to send to support. Copy or download. - [Design Doc Template (Technical Design Document) in Markdown](https://foliowiki.online/templates/design-doc/): Free design doc (technical design document) template in Markdown with a filled example: goals, proposed design, alternatives, rollout. Copy or download. - [Engineering Handbook Template (Markdown)](https://foliowiki.online/templates/engineering-handbook/): Free engineering handbook template in Markdown with a filled example: how a team works, ships, runs production and decides. Copy or download the file. ## Blog - [Folio blog](https://foliowiki.online/blog/): Notes from the Folio team: what changed in the product and how it works inside. Open source, self-hosted, stored in Git. - [Folio 0.4.3: a calmer interface, redesigned after your feedback](https://foliowiki.online/blog/folio-0-4-3-redesign/): Folio 0.4.3 reworks the app chrome after user feedback: one-column sidebar, a lighter header, properties under the title and a tidier right panel. - [MCP security for a wiki: OAuth, tokens and page permissions](https://foliowiki.online/blog/mcp-security-wiki-oauth-tokens-permissions/): Is it safe to give an AI agent your wiki? What the MCP spec says about OAuth, and how Folio handles tokens, page permissions and audit. - [LLM wiki for a team: Markdown in Git, readable by agents over MCP](https://foliowiki.online/blog/llm-wiki-markdown-git-mcp-for-teams/): What an LLM wiki is, where Karpathy's pattern breaks for a team, and how a Markdown wiki in Git gives agents rights, history and MCP access. - [Obsidian Bases outside Obsidian: open and edit .base files in a browser](https://foliowiki.online/blog/obsidian-bases-outside-obsidian/): What an Obsidian base and a .base file are, and what Folio does with one in the browser: views, filters, formulas, cell editing, agents, and the gaps. - [Obsidian MCP: ways to give an AI agent your vault](https://foliowiki.online/blog/obsidian-mcp-server-ai-agent-vault/): Six ways to give Claude or another AI agent your Obsidian vault over MCP: REST plugin, file-based servers, CLI, Git and a team wiki. One comparison table. - [Notion vs Obsidian for a team: what each one gives you, and when neither fits](https://foliowiki.online/blog/notion-vs-obsidian-for-a-team/): Notion vs Obsidian for a team, row by row: where data lives, offline, collaboration, permissions, AI, price and self-hosting, with sources and dates. - [Mermaid vs PlantUML: which to use for docs in Git](https://foliowiki.online/blog/mermaid-vs-plantuml/): Mermaid vs PlantUML in one table: syntax, diagram types, rendering, GitHub, GitLab, Obsidian and Folio support, licenses, and when to pick each. - [Groups and single sign-on in an open-source wiki: free, in one MIT edition](https://foliowiki.online/blog/wiki-groups-sso-saml-scim/): Folio 0.4.2: OpenID Connect and SAML 2.0 sign-in, SCIM, groups from your identity provider, page rights child pages inherit and an audit log. All free. - [Side-by-side comparison of wiki pages and versions: see what changed](https://foliowiki.online/blog/compare-wiki-pages-and-versions/): Side-by-side comparison in Folio: up to five pages, tables, boards or versions in one window. Edit live, highlight changes, share a link. - [Publish a Cursor canvas to your team wiki: dashboards that outlive the chat](https://foliowiki.online/blog/publish-cursor-canvas-to-a-wiki/): A Cursor canvas lives on your machine. Folio keeps it as an interactive wiki page in Git. We ran it with Cursor's agent: what worked and what did not. - [Publish a Claude artifact to your team wiki: interactive pages that live in Git](https://foliowiki.online/blog/publish-claude-artifacts-to-a-wiki/): A Claude artifact or Cursor canvas usually dies with the chat. Folio keeps it as an interactive wiki page in Git. Publish over MCP or import it by hand. - [Make any page a template: custom templates for your Folio space](https://foliowiki.online/blog/custom-space-templates/): Turn any Folio page, board, table or page tree into a template. New pages get the date and author filled in. Templates are files in Git. - [Confluence MCP, Notion MCP and a wiki that is its own MCP server](https://foliowiki.online/blog/wiki-mcp-server-for-ai-agents/): What Atlassian and Notion offer AI agents over MCP, and how a self-hosted wiki with its own MCP server differs: user rights, Git history, edits people see. - [Export Confluence to Markdown and keep it in Git](https://foliowiki.online/blog/export-confluence-to-markdown-git/): Export a whole Confluence space to Markdown with hierarchy: HTML export and Pandoc, REST API, a free converter, Marketplace apps or Folio's import. - [Mermaid diagrams in a team wiki: keep them as code](https://foliowiki.online/blog/mermaid-diagrams-in-a-wiki/): Why keep diagrams as Mermaid code beside the docs: flowchart, sequence and ER examples, where Mermaid renders, how Folio edits it and a free live editor. - [See how your team's knowledge connects: graph, Canvas and Bases in Folio 0.4](https://foliowiki.online/blog/folio-0-4-graph-canvas-bases/): Folio 0.4 adds a space graph and a local graph that respect page access, opens Obsidian Canvas and Bases, a shared timer and Slack and Teams link previews. - [Open an Obsidian vault as a team wiki, without changing a file](https://foliowiki.online/blog/obsidian-vault-team-wiki/): Folio 0.3 opens an Obsidian vault in the browser for a team and leaves the files untouched. Wikilinks, callouts, properties, how we tested it, the limits. - [Publish a wiki space as a public website, and let visitors ask it questions](https://foliowiki.online/blog/publish-wiki-space-as-public-website/): Folio 0.2 publishes a wiki space as a public website, adds a shared Folio AI key and an Ask Folio AI box for visitors. How it works and where it stops. - [Docs-as-code without the IDE: edit your repository's docs in a browser](https://foliowiki.online/blog/docs-as-code-in-the-browser/): What is docs as code? Markdown docs in Git, edited in a browser by people who do not use Git, each edit a normal commit. How Folio syncs, and its limits. - [New hires ask the wiki, and the wiki learns what it lacks](https://foliowiki.online/blog/ai-onboarding-assistant-wiki/): A new hire asks the wiki and gets an answer with its source. Each question the pages cannot answer tells an admin what to write next. How it works. - [Folio boards: built on Excalidraw, made for teams](https://foliowiki.online/blog/folio-boards-built-on-excalidraw/): Sticky notes, emoji reactions, one-click headings and live co-editing on top of Excalidraw, with boards stored as files in your Git repository. - [Folio blog: Releases](https://foliowiki.online/blog/tag/releases/): What changed in each Folio release and where things moved. - [Folio blog: AI & MCP](https://foliowiki.online/blog/tag/ai-mcp/): AI agents, the MCP server, the built-in assistant and how they reach your wiki. - [Folio blog: Docs as code](https://foliowiki.online/blog/tag/docs-as-code/): Markdown in Git, Mermaid and docs that live next to the code. - [Folio blog: Obsidian](https://foliowiki.online/blog/tag/obsidian/): Open an Obsidian vault, Bases, and working next to Obsidian. - [Folio blog: Confluence](https://foliowiki.online/blog/tag/confluence/): Leaving Confluence, exporting pages and how Folio compares. - [Folio blog: Collaboration](https://foliowiki.online/blog/tag/collaboration/): Boards, templates, versions, onboarding and working together in a space. - [Folio blog: Security & access](https://foliowiki.online/blog/tag/security-access/): Permissions, tokens, groups and single sign-on. - [Folio blog: Publishing](https://foliowiki.online/blog/tag/publishing/): Turn pages, artifacts and whole spaces into something others can read. - [Folio blog: How-to](https://foliowiki.online/blog/tag/how-to/): Step-by-step posts with the commands, screens and limits stated. - [Folio blog: Comparisons](https://foliowiki.online/blog/tag/comparisons/): Folio and other tools side by side, with the trade-offs stated. ## Guides - [Folio guides](https://foliowiki.online/guides/): Step-by-step guides for Folio: connect a Git repository, invite a team, keep your own editor. Open source, self-hosted, stored in Git. - [Obsidian and Claude Code: a shared second brain for a team](https://foliowiki.online/guides/obsidian-claude-code-team-second-brain/): Use Claude Code with an Obsidian vault, then share it: CLAUDE.md, Git, a team wiki and MCP, so every colleague's agent answers from the same notes. - [Make Obsidian multiplayer with Folio](https://foliowiki.online/guides/obsidian-multiplayer/): Can several people edit one Obsidian vault? Compare Sync, Git, LiveSync, Syncthing and Folio, then set up a team vault in Git with roles. Steps, limits. ## Compare - [Compare Folio](https://foliowiki.online/compare/): Compare Folio with Confluence, Notion, Outline, Obsidian, Nimbus, MediaWiki, Miro and a conventional wiki by workflow and ownership. - [Folio vs. Confluence](https://foliowiki.online/compare/confluence/): Compare Folio and Confluence for Git-native documentation, collaboration, agents, migration, permissions and enterprise administration. - [Folio vs. Notion](https://foliowiki.online/compare/notion/): Compare Folio and Notion for Git ownership, documents, databases, AI agents, deployment and a practical exit path. - [Folio vs. Outline](https://foliowiki.online/compare/outline/): Compare Folio and Outline for Git-native storage, licensing, self-hosting, sign-in, agents and MCP, migration and pricing. - [Folio vs. Obsidian](https://foliowiki.online/compare/obsidian/): Compare Folio and Obsidian for teams: browser access, shared editing, page permissions, Git, Markdown syntax, pricing, and when to stay on Obsidian. - [Folio vs. Nimbus](https://foliowiki.online/compare/nimbus/): Nimbus is Cloudflare's Astro docs generator. Folio is a visual MDX editor for its docs folder: components kept byte for byte, one-paragraph commits. - [Folio vs. MediaWiki](https://foliowiki.online/compare/mediawiki/): Compare Folio and MediaWiki for internal knowledge, Git-native history, editing, extensions, public scale and agent access. - [Folio vs. Miro](https://foliowiki.online/compare/miro/): Compare Folio and Miro for whiteboards, workshops, Git history, documents, tables, agents, sharing and restoration. - [Folio vs. a conventional wiki](https://foliowiki.online/compare/wiki/): Compare Folio with a conventional internal wiki by source of truth, developer workflow, collaboration, agents, self-hosting and exit path. ## Alternatives - [Alternatives](https://foliowiki.online/alternatives/): Honest lists of open-source, self-hosted alternatives to Confluence and Notion, and of wiki software. Licenses, prices and limits checked on each site. - [Open-source and self-hosted Confluence alternatives](https://foliowiki.online/alternatives/confluence/): Eight self-hosted Confluence alternatives: Docmost, Outline, XWiki, Folio, BookStack, Wiki.js, AFFiNE, MediaWiki. Licenses, prices, drawbacks. Oct 2026. - [Self-hosted and open-source Notion alternatives](https://foliowiki.online/alternatives/notion/): Seven self-hosted or local Notion alternatives: AFFiNE, AppFlowy, Anytype, Outline, Docmost, Folio, SiYuan. Licenses, prices, drawbacks. Oct 2026. - [Self-hosted wiki software for a team or company wiki](https://foliowiki.online/alternatives/self-hosted-wiki/): Eight self-hosted team wikis compared: BookStack, Wiki.js, DokuWiki, MediaWiki, XWiki, Outline, Docmost, Folio. Which store plain files or sync with Git. ## Questions this site answers - [Is Folio really free?](https://foliowiki.online/#faq) - [Who built it?](https://foliowiki.online/#faq) - [Do I need an AI subscription?](https://foliowiki.online/#faq) - [Can I try it without installing?](https://foliowiki.online/#faq) - [Can I publish a space as a public website?](https://foliowiki.online/#faq) - [Can I connect ChatGPT, Claude or Cursor?](https://foliowiki.online/#faq) - [What happens to my pages if I stop using Folio?](https://foliowiki.online/#faq) - [Can I move my Confluence space over?](https://foliowiki.online/#faq) - [Where do I report a bug or a security issue?](https://foliowiki.online/#faq) - [What do I need to connect an AI client to Folio?](https://foliowiki.online/integrations/#faq) - [Which AI clients work with Folio over MCP?](https://foliowiki.online/integrations/#faq) - [How do I add Folio to Cursor, Codex or Claude Code in one step?](https://foliowiki.online/integrations/#faq) - [Can I connect ChatGPT to Folio?](https://foliowiki.online/integrations/#faq) - [Can I connect Claude to Folio?](https://foliowiki.online/integrations/#faq) - [Does my Folio have to be on the public internet?](https://foliowiki.online/integrations/#faq) - [Can an agent see pages I cannot?](https://foliowiki.online/integrations/#faq) - [How do I cut an agent off?](https://foliowiki.online/integrations/#faq) - [Is there a hosted Folio I can point Claude at?](https://foliowiki.online/integrations/#faq) - [Are these templates really free?](https://foliowiki.online/templates/#faq) - [Can I use them in Confluence, Notion or Google Docs?](https://foliowiki.online/templates/#faq) - [What do the {{double braces}} mean?](https://foliowiki.online/templates/#faq) - [How do I connect Claude Desktop to Folio as an MCP server?](https://foliowiki.online/integrations/claude/#faq) - [Do I edit claude_desktop_config.json for Folio?](https://foliowiki.online/integrations/claude/#faq) - [Why does Claude say it cannot reach my Folio?](https://foliowiki.online/integrations/claude/#faq) - [Can Claude write to my wiki, or only read it?](https://foliowiki.online/integrations/claude/#faq) - [Can Claude use a personal access token instead of OAuth?](https://foliowiki.online/integrations/claude/#faq) - [How do I add Folio to ChatGPT as a custom MCP server?](https://foliowiki.online/integrations/chatgpt/#faq) - [Can ChatGPT deep research use my Folio wiki?](https://foliowiki.online/integrations/chatgpt/#faq) - [Can ChatGPT connect to Folio with a token?](https://foliowiki.online/integrations/chatgpt/#faq) - [Does my Folio need a public address for ChatGPT?](https://foliowiki.online/integrations/chatgpt/#faq) - [How do I connect Claude Code to Folio?](https://foliowiki.online/integrations/claude-code/#faq) - [Can Claude Code edit my Folio wiki, or only read it?](https://foliowiki.online/integrations/claude-code/#faq) - [Can Claude Code see pages I am not allowed to open?](https://foliowiki.online/integrations/claude-code/#faq) - [Where do Claude Code's edits end up?](https://foliowiki.online/integrations/claude-code/#faq) - [How do I add an MCP server to Claude Code for a whole team?](https://foliowiki.online/integrations/claude-code/#faq) - [Why does claude mcp list show Folio as failed?](https://foliowiki.online/integrations/claude-code/#faq) - [How do I add an MCP server to Cursor?](https://foliowiki.online/integrations/cursor/#faq) - [What is the Folio config for Cursor?](https://foliowiki.online/integrations/cursor/#faq) - [Can Cursor use OAuth with Folio?](https://foliowiki.online/integrations/cursor/#faq) - [Can Cursor read my internal docs and conventions from Folio?](https://foliowiki.online/integrations/cursor/#faq) - [Does the agent write to Folio without asking?](https://foliowiki.online/integrations/cursor/#faq) - [How do I add an MCP server to VS Code?](https://foliowiki.online/integrations/vscode/#faq) - [How does VS Code keep my Folio token out of the repository?](https://foliowiki.online/integrations/vscode/#faq) - [Can GitHub Copilot in VS Code use my wiki?](https://foliowiki.online/integrations/vscode/#faq) - [How do I add an MCP server to Codex?](https://foliowiki.online/integrations/codex/#faq) - [Can I sign in to Folio from Codex with OAuth instead of a token?](https://foliowiki.online/integrations/codex/#faq) - [Does the ChatGPT account that Codex uses also give me Folio in ChatGPT chat?](https://foliowiki.online/integrations/codex/#faq) - [How do I connect n8n to an MCP server like Folio?](https://foliowiki.online/integrations/n8n/#faq) - [Which Folio tools should an n8n agent get?](https://foliowiki.online/integrations/n8n/#faq) - [Can an edit in Folio start an n8n workflow?](https://foliowiki.online/integrations/n8n/#faq) - [How do I add an MCP server to Open WebUI?](https://foliowiki.online/integrations/open-webui/#faq) - [Which Folio token should Open WebUI use?](https://foliowiki.online/integrations/open-webui/#faq) - [What if my Open WebUI is older than 0.6.31?](https://foliowiki.online/integrations/open-webui/#faq) - [Does Confluence have a built-in export to Markdown?](https://foliowiki.online/tools/confluence-to-markdown/#faq) - [How do I export a whole Confluence space to Markdown with hierarchy?](https://foliowiki.online/tools/confluence-to-markdown/#faq) - [Is there a free converter that does not upload my pages?](https://foliowiki.online/tools/confluence-to-markdown/#faq) - [How do I convert Confluence storage format (XML) to Markdown?](https://foliowiki.online/tools/confluence-to-markdown/#faq) - [Why did a macro become a comment, and what else gets lost?](https://foliowiki.online/tools/confluence-to-markdown/#faq) - [Why are images missing after the export?](https://foliowiki.online/tools/confluence-to-markdown/#faq) - [How do I convert Mermaid to PNG?](https://foliowiki.online/tools/mermaid-editor/#faq) - [Can I get a transparent PNG?](https://foliowiki.online/tools/mermaid-editor/#faq) - [How do I make a Gantt chart in Mermaid?](https://foliowiki.online/tools/mermaid-editor/#faq) - [How do I draw an ER diagram in Mermaid?](https://foliowiki.online/tools/mermaid-editor/#faq) - [Is the Mermaid editor free, and is my diagram sent to a server?](https://foliowiki.online/tools/mermaid-editor/#faq) - [Why do I get a syntax error?](https://foliowiki.online/tools/mermaid-editor/#faq) - [What is the difference between meeting notes and meeting minutes?](https://foliowiki.online/templates/meeting-notes/#faq) - [Who should take the notes?](https://foliowiki.online/templates/meeting-notes/#faq) - [How long should meeting notes be?](https://foliowiki.online/templates/meeting-notes/#faq) - [Can I use this template for recurring meetings?](https://foliowiki.online/templates/meeting-notes/#faq) - [Where should I store meeting notes?](https://foliowiki.online/templates/meeting-notes/#faq) - [What is the difference between an SOP, a policy and a work instruction?](https://foliowiki.online/templates/sop/#faq) - [How detailed should an SOP be?](https://foliowiki.online/templates/sop/#faq) - [How often should an SOP be reviewed?](https://foliowiki.online/templates/sop/#faq) - [Should an SOP be a Word file, a PDF or a wiki page?](https://foliowiki.online/templates/sop/#faq) - [Can I use this template for compliance work?](https://foliowiki.online/templates/sop/#faq) - [What should a PRD include?](https://foliowiki.online/templates/prd/#faq) - [What is the difference between a PRD and a design doc?](https://foliowiki.online/templates/prd/#faq) - [How long should a PRD be?](https://foliowiki.online/templates/prd/#faq) - [Who writes and who approves a PRD?](https://foliowiki.online/templates/prd/#faq) - [Is a PRD still useful for agile teams?](https://foliowiki.online/templates/prd/#faq) - [How do I write a PRD that an AI agent can use?](https://foliowiki.online/templates/prd/#faq) - [How often should one-on-ones happen?](https://foliowiki.online/templates/one-on-one/#faq) - [What should we talk about in a one-on-one?](https://foliowiki.online/templates/one-on-one/#faq) - [Is it safe to keep one-on-one notes in a shared document?](https://foliowiki.online/templates/one-on-one/#faq) - [What if there is nothing to discuss?](https://foliowiki.online/templates/one-on-one/#faq) - [Should the employee see the manager's notes?](https://foliowiki.online/templates/one-on-one/#faq) - [What is the difference between release notes and a changelog?](https://foliowiki.online/templates/release-notes/#faq) - [What should release notes include?](https://foliowiki.online/templates/release-notes/#faq) - [How often should I publish release notes?](https://foliowiki.online/templates/release-notes/#faq) - [Should release notes mention security fixes?](https://foliowiki.online/templates/release-notes/#faq) - [Where should release notes live?](https://foliowiki.online/templates/release-notes/#faq) - [What should an employee onboarding checklist include?](https://foliowiki.online/templates/onboarding-checklist/#faq) - [How long should onboarding last?](https://foliowiki.online/templates/onboarding-checklist/#faq) - [Who is responsible for onboarding?](https://foliowiki.online/templates/onboarding-checklist/#faq) - [Can this checklist be used for remote employees?](https://foliowiki.online/templates/onboarding-checklist/#faq) - [How do I help new hires find answers without interrupting everyone?](https://foliowiki.online/templates/onboarding-checklist/#faq) - [What is the difference between a runbook and a playbook?](https://foliowiki.online/templates/runbook/#faq) - [What should a runbook contain?](https://foliowiki.online/templates/runbook/#faq) - [How is a runbook different from an SOP?](https://foliowiki.online/templates/runbook/#faq) - [Where should runbooks be stored?](https://foliowiki.online/templates/runbook/#faq) - [Can a runbook be automated?](https://foliowiki.online/templates/runbook/#faq) - [What is a blameless postmortem?](https://foliowiki.online/templates/postmortem/#faq) - [When should we write a postmortem?](https://foliowiki.online/templates/postmortem/#faq) - [How long should a postmortem take?](https://foliowiki.online/templates/postmortem/#faq) - [Who should read postmortems?](https://foliowiki.online/templates/postmortem/#faq) - [What is the difference between a postmortem and a retrospective?](https://foliowiki.online/templates/postmortem/#faq) - [What is a how-to guide?](https://foliowiki.online/templates/how-to-guide/#faq) - [How is a how-to guide different from a tutorial?](https://foliowiki.online/templates/how-to-guide/#faq) - [How long should a how-to guide be?](https://foliowiki.online/templates/how-to-guide/#faq) - [Should a how-to guide be generated by AI?](https://foliowiki.online/templates/how-to-guide/#faq) - [Where should how-to guides live?](https://foliowiki.online/templates/how-to-guide/#faq) - [What should API documentation include?](https://foliowiki.online/templates/api-reference/#faq) - [What is the difference between an API reference and an API guide?](https://foliowiki.online/templates/api-reference/#faq) - [Should I write API docs by hand or generate them from OpenAPI?](https://foliowiki.online/templates/api-reference/#faq) - [How do I document API versions and breaking changes?](https://foliowiki.online/templates/api-reference/#faq) - [How do I keep API docs up to date?](https://foliowiki.online/templates/api-reference/#faq) - [What is a troubleshooting guide?](https://foliowiki.online/templates/troubleshooting-guide/#faq) - [How is a troubleshooting guide different from a runbook?](https://foliowiki.online/templates/troubleshooting-guide/#faq) - [What should I put at the top of a troubleshooting article?](https://foliowiki.online/templates/troubleshooting-guide/#faq) - [How do I write a diagnosis flowchart?](https://foliowiki.online/templates/troubleshooting-guide/#faq) - [How often should a troubleshooting guide be reviewed?](https://foliowiki.online/templates/troubleshooting-guide/#faq) - [What is a design doc?](https://foliowiki.online/templates/design-doc/#faq) - [What is the difference between a design doc and a PRD?](https://foliowiki.online/templates/design-doc/#faq) - [How long should a design doc be?](https://foliowiki.online/templates/design-doc/#faq) - [When do I need a design doc?](https://foliowiki.online/templates/design-doc/#faq) - [Who should review a design doc?](https://foliowiki.online/templates/design-doc/#faq) - [Where should a design doc live?](https://foliowiki.online/templates/design-doc/#faq) - [What is an engineering handbook?](https://foliowiki.online/templates/engineering-handbook/#faq) - [What should an engineering handbook contain?](https://foliowiki.online/templates/engineering-handbook/#faq) - [How is an engineering handbook different from onboarding documentation?](https://foliowiki.online/templates/engineering-handbook/#faq) - [Should the handbook be public?](https://foliowiki.online/templates/engineering-handbook/#faq) - [How do I keep an engineering handbook up to date?](https://foliowiki.online/templates/engineering-handbook/#faq) - [Is it safe to give an AI agent access to a company wiki?](https://foliowiki.online/blog/mcp-security-wiki-oauth-tokens-permissions/#faq) - [Does MCP respect page-level permissions?](https://foliowiki.online/blog/mcp-security-wiki-oauth-tokens-permissions/#faq) - [What does the MCP specification say about OAuth?](https://foliowiki.online/blog/mcp-security-wiki-oauth-tokens-permissions/#faq) - [Can an MCP agent change page permissions in Folio?](https://foliowiki.online/blog/mcp-security-wiki-oauth-tokens-permissions/#faq) - [How long do Folio MCP tokens last?](https://foliowiki.online/blog/mcp-security-wiki-oauth-tokens-permissions/#faq) - [What is an LLM wiki?](https://foliowiki.online/blog/llm-wiki-markdown-git-mcp-for-teams/#faq) - [What is the difference between an LLM wiki and RAG?](https://foliowiki.online/blog/llm-wiki-markdown-git-mcp-for-teams/#faq) - [Can an LLM wiki work in Obsidian?](https://foliowiki.online/blog/llm-wiki-markdown-git-mcp-for-teams/#faq) - [Is an LLM knowledge base safe for a team?](https://foliowiki.online/blog/llm-wiki-markdown-git-mcp-for-teams/#faq) - [How does an agent read a Folio wiki?](https://foliowiki.online/blog/llm-wiki-markdown-git-mcp-for-teams/#faq) - [What is a .base file in Obsidian?](https://foliowiki.online/blog/obsidian-bases-outside-obsidian/#faq) - [Can I open a .base file without Obsidian?](https://foliowiki.online/blog/obsidian-bases-outside-obsidian/#faq) - [Does Folio support Obsidian Bases kanban and map views?](https://foliowiki.online/blog/obsidian-bases-outside-obsidian/#faq) - [Can I edit values in a base in Folio?](https://foliowiki.online/blog/obsidian-bases-outside-obsidian/#faq) - [Can an AI agent query an Obsidian base?](https://foliowiki.online/blog/obsidian-bases-outside-obsidian/#faq) - [What is an Obsidian MCP server?](https://foliowiki.online/blog/obsidian-mcp-server-ai-agent-vault/#faq) - [Does Obsidian need to be open for an agent to use my vault?](https://foliowiki.online/blog/obsidian-mcp-server-ai-agent-vault/#faq) - [Is it safe to give an AI agent write access to my vault?](https://foliowiki.online/blog/obsidian-mcp-server-ai-agent-vault/#faq) - [Can Claude Code read my Obsidian vault without MCP?](https://foliowiki.online/blog/obsidian-mcp-server-ai-agent-vault/#faq) - [How can a team of several people use one Obsidian vault with AI agents?](https://foliowiki.online/blog/obsidian-mcp-server-ai-agent-vault/#faq) - [Is Obsidian better than Notion for a team?](https://foliowiki.online/blog/notion-vs-obsidian-for-a-team/#faq) - [Can Obsidian replace Notion?](https://foliowiki.online/blog/notion-vs-obsidian-for-a-team/#faq) - [Is Obsidian free for a team?](https://foliowiki.online/blog/notion-vs-obsidian-for-a-team/#faq) - [Can you self-host Notion or Obsidian?](https://foliowiki.online/blog/notion-vs-obsidian-for-a-team/#faq) - [What is a good Obsidian alternative for a team?](https://foliowiki.online/blog/notion-vs-obsidian-for-a-team/#faq) - [Is Mermaid or PlantUML better for documentation in Git?](https://foliowiki.online/blog/mermaid-vs-plantuml/#faq) - [Does GitHub render PlantUML?](https://foliowiki.online/blog/mermaid-vs-plantuml/#faq) - [Does GitLab support Mermaid and PlantUML?](https://foliowiki.online/blog/mermaid-vs-plantuml/#faq) - [Is PlantUML free, and what license is it under?](https://foliowiki.online/blog/mermaid-vs-plantuml/#faq) - [Does Mermaid need Java or a server?](https://foliowiki.online/blog/mermaid-vs-plantuml/#faq) - [Can I use PlantUML in Folio?](https://foliowiki.online/blog/mermaid-vs-plantuml/#faq) - [Does Confluence have a built-in export to Markdown?](https://foliowiki.online/blog/export-confluence-to-markdown-git/#faq) - [How do I export a whole Confluence space to Markdown with hierarchy?](https://foliowiki.online/blog/export-confluence-to-markdown-git/#faq) - [How do I convert a Confluence HTML export to Markdown?](https://foliowiki.online/blog/export-confluence-to-markdown-git/#faq) - [Why are images and attachments missing after the export?](https://foliowiki.online/blog/export-confluence-to-markdown-git/#faq) - [How do I convert Confluence macros such as info panels and code blocks?](https://foliowiki.online/blog/export-confluence-to-markdown-git/#faq) - [What does not move when I leave Confluence: permissions, comments, history?](https://foliowiki.online/blog/export-confluence-to-markdown-git/#faq) - [What is docs as code?](https://foliowiki.online/blog/docs-as-code-in-the-browser/#faq) - [Can people who do not use Git contribute to docs as code?](https://foliowiki.online/blog/docs-as-code-in-the-browser/#faq) - [Is there a WYSIWYG Markdown editor that saves to Git?](https://foliowiki.online/blog/docs-as-code-in-the-browser/#faq) - [Does Folio replace my static site generator?](https://foliowiki.online/blog/docs-as-code-in-the-browser/#faq) - [Will connecting Folio change the files in my docs folder?](https://foliowiki.online/blog/docs-as-code-in-the-browser/#faq) - [Can Claude Code use my Obsidian vault?](https://foliowiki.online/guides/obsidian-claude-code-team-second-brain/#faq) - [Do I need an Obsidian AI plugin to use Claude with my notes?](https://foliowiki.online/guides/obsidian-claude-code-team-second-brain/#faq) - [How do I build a shared second brain with Claude for a team?](https://foliowiki.online/guides/obsidian-claude-code-team-second-brain/#faq) - [Can Claude write to the shared vault?](https://foliowiki.online/guides/obsidian-claude-code-team-second-brain/#faq) - [What does Claude Code not do with a vault in Folio?](https://foliowiki.online/guides/obsidian-claude-code-team-second-brain/#faq) - [Can multiple people edit the same Obsidian vault at the same time?](https://foliowiki.online/guides/obsidian-multiplayer/#faq) - [How can a team share an Obsidian vault?](https://foliowiki.online/guides/obsidian-multiplayer/#faq) - [Does the Obsidian Git plugin work for a team?](https://foliowiki.online/guides/obsidian-multiplayer/#faq) - [Can you self-host Obsidian?](https://foliowiki.online/guides/obsidian-multiplayer/#faq) - [Do my colleagues need Obsidian?](https://foliowiki.online/guides/obsidian-multiplayer/#faq) - [Will Folio change my notes?](https://foliowiki.online/guides/obsidian-multiplayer/#faq) - [Is Nimbus an alternative to Folio?](https://foliowiki.online/compare/nimbus/#faq) - [Does Nimbus have a hosted version, a price or an OpenAPI reference?](https://foliowiki.online/compare/nimbus/#faq) - [Does Folio publish llms.txt and Markdown for agents?](https://foliowiki.online/compare/nimbus/#faq) - [Is there a visual editor or CMS for Nimbus docs?](https://foliowiki.online/compare/nimbus/#faq) - [Can non-developers edit MDX without breaking components?](https://foliowiki.online/compare/nimbus/#faq) - [Does Folio commit directly or open a pull request?](https://foliowiki.online/compare/nimbus/#faq) - [What is the best open-source alternative to Confluence?](https://foliowiki.online/alternatives/confluence/#faq) - [Is there a free Confluence alternative?](https://foliowiki.online/alternatives/confluence/#faq) - [Can I import my Confluence spaces?](https://foliowiki.online/alternatives/confluence/#faq) - [What happens to self-managed Confluence (Data Center)?](https://foliowiki.online/alternatives/confluence/#faq) - [Which of these have SSO without paying?](https://foliowiki.online/alternatives/confluence/#faq) - [Is Folio a Confluence replacement?](https://foliowiki.online/alternatives/confluence/#faq) - [What is the best open-source or self-hosted Notion alternative?](https://foliowiki.online/alternatives/notion/#faq) - [Can I use Obsidian instead of Notion for a team?](https://foliowiki.online/alternatives/notion/#faq) - [Is there a free Notion alternative?](https://foliowiki.online/alternatives/notion/#faq) - [Which of these are truly open source?](https://foliowiki.online/alternatives/notion/#faq) - [Can I import my Notion workspace?](https://foliowiki.online/alternatives/notion/#faq) - [Does Notion offer self-hosting?](https://foliowiki.online/alternatives/notion/#faq) - [Is there a self-hosted Markdown wiki I can git push to?](https://foliowiki.online/alternatives/self-hosted-wiki/#faq) - [What is the best self-hosted team wiki, and the easiest to run?](https://foliowiki.online/alternatives/self-hosted-wiki/#faq) - [Which open-source knowledge base should I pick?](https://foliowiki.online/alternatives/self-hosted-wiki/#faq) - [Which wikis store pages as plain Markdown files?](https://foliowiki.online/alternatives/self-hosted-wiki/#faq) - [Which self-hosted wikis include SSO for free?](https://foliowiki.online/alternatives/self-hosted-wiki/#faq) - [Can I run a company wiki for free?](https://foliowiki.online/alternatives/self-hosted-wiki/#faq) ## Support - [Folio support](https://foliowiki.online/support/): Get help with Folio, the self-hosted Git wiki: report a bug or ask on GitHub, what to include, report a vulnerability privately, what support to expect. ## Try and source code - [Live demo](https://demo.foliowiki.online): Public Folio instance. Pick Sam on the sign-in screen; data resets every 24 hours. - [GitHub repository](https://github.com/evergreen-it-dev/folio): Source code, MIT license, docs and issues. ## Legal - [Privacy policy](https://foliowiki.online/privacy/) - [Terms of use](https://foliowiki.online/terms/)