Folio vs. Outline
Choose Folio when the wiki should be Markdown files in your own Git repository, under an MIT license. Outline is the stronger product on hosting options and ecosystem: a hosted cloud, a documented API, desktop apps and a long integration list. Enterprise sign-in is a plus for Folio: OpenID Connect, SAML 2.0, SCIM, groups synced from the identity provider and an audit log are all in its one MIT edition, while in Outline SAML, the audit log and the guest role are in licensed editions, there is no SCIM, and groups are made by hand only. Outline keeps documents in PostgreSQL, and its code is under the Business Source License 1.1, which its own license file says is not an open-source license.
The workflow difference
In Outline, a document is a record in PostgreSQL, and attachments go to S3-compatible storage or local disk. It saves a revision at least every five minutes of editing and exports a collection or the whole workspace as Markdown, HTML or JSON. Its GitHub and GitLab integrations preview issues, pull requests and merge requests inside documents; its documentation describes no Git-backed storage and no two-way Git sync.
In Folio, a page is a Markdown file in your Git repository. A browser edit becomes a commit after about 90 seconds of quiet, a push from an IDE returns to the wiki, and agents reach the same files through 49 MCP tools. Outline also ships an MCP server that can search, read, create and edit documents, so the difference is where the documents live, not whether agents can write.
Side by side
Rows marked Plus are where Folio is ahead.
| Area | Folio | Outline |
|---|---|---|
| Source of truth | Markdown, table and board files in your Git repository | Documents in PostgreSQL; attachments in S3-compatible storage or on local disk |
| License | MIT | Business Source License 1.1: source-available, no use as a document service for third parties; becomes Apache 2.0 on the Change Date, 2030-09-09 |
| Hosting | Self-hosted with Docker: the app, PostgreSQL and Redis. No hosted version | Hosted cloud, or self-hosted with Docker, PostgreSQL 14+ and Redis 4+ |
| Price | Free software; you pay for your server and any AI subscription you connect | Cloud: $10, $79 or $249 a month for 1-10, 11-100 or 101-200 members, 30-day trial. Community edition is free to self-host; licensed editions are bought from Outline |
| Edition limits | PlusOne MIT edition: SSO, SCIM, groups and the audit log are all in it | Self-hosted community edition has no SAML, audit log, Confluence importer, PDF export, AI answers or guest role; the licensed edition (Business) adds them |
| Editing | Reading, live edit and source modes over plain Markdown | Rich-text editor that converts typed or pasted Markdown; slash commands, templates, comments |
| Git workflow | Git is the live content history; IDE edits sync back | No Git-backed storage; GitHub and GitLab integrations preview issues, pull requests and merge requests |
| History | Git commits with the editor as author | Revisions at least every five minutes, with diff and restore |
| Collaboration | Real-time documents, tables and whiteboards | Real-time editing with cursors and observer mode, comments and threads |
| Structured data and diagrams | Typed data tables and forms as Markdown files; Mermaid and Excalidraw boards | Tables in documents with CSV export; Mermaid and diagrams.net; document properties in licensed editions (preview) |
| Agents | Built-in Folio AI (Ask and Agent) on a Cursor key, personal or shared; 49 MCP tools with read or write scope over pages, boards, tables, forms and bases | MCP server with OAuth or API key to search, read, create and edit documents; AI answers through OpenAI in cloud and licensed editions |
| API and integrations | REST API with personal access tokens; MCP with tokens or OAuth 2.1 | Documented API with scoped keys, OAuth provider, webhooks; integrations include Slack, GitHub, GitLab, Linear, Figma and Jira |
| Sign-in | PlusEmail and password, Google, any OpenID Connect provider (Keycloak, Authentik, Entra ID, Okta) and SAML 2.0 (Entra ID, Okta, Keycloak, Google Workspace, ADFS). SSO can be enforced per email domain, with an audited admin break-glass. SCIM 2.0 provisions users and groups (Okta, Entra ID) | Google, Microsoft Entra, Slack, Discord, GitLab, OIDC, passkeys and email magic link. SAML only in licensed editions; no SCIM provisioning |
| Permissions | PlusRoles per space and rights per page; a page restriction is inherited by child pages, which can narrow it but not widen it. Groups, made by hand or synced from the identity provider at sign-in or through SCIM, hold space roles and page grants; groups cannot be nested | Collection permissions, sharing with users and groups, public links. Groups are made and filled by hand; there is no group sync from an identity provider |
| Audit and sessions | PlusAudit log screen with CSV export. Sign out other devices; deactivating a person revokes their sessions, API tokens and MCP connections | Audit log in licensed editions only |
| Migration in | Confluence importer; no Outline importer | Imports Confluence (cloud and licensed editions), Notion, Word, Markdown, HTML and text files |
| Migration out | The repository already holds the files; export md, pdf, docx, yaml or a zip of a space | Markdown, HTML or JSON per collection or workspace; PDF only in cloud and licensed editions |
| Apps | Responsive web interface; no native app | Desktop apps for macOS and Windows; no native mobile apps, installable as a PWA |
| Try it | Public demo at demo.foliowiki.online (shared login, resets every 24 hours); or run it yourself with docker compose | 30-day free trial in the cloud |
What Folio changes
- Plus for FolioSAML, SCIM provisioning, groups synced from your identity provider and the audit log are all in the one MIT edition. In Outline, SAML, the audit log and guests need a licensed edition, there is no SCIM, and groups are manual.
- Pages, data tables, forms and Excalidraw boards are ordinary files you can review, branch and revert with Git.
- Leaving Folio leaves Markdown and assets in your repository. Leaving Outline means an export, in Markdown, HTML or JSON.
- The whole product is MIT. Outline's license forbids offering it as a document service to third parties, and some features exist only in its licensed editions.
- The cost: you operate Folio, PostgreSQL and Redis yourself, and there is no hosted version.
Where Folio is the better choice
Choose Folio when documentation should live as Markdown files in a Git repository you control. Browser edits, IDE edits and agents work on the same files, tables and Excalidraw boards are files too, and the built-in assistant runs on a Cursor key, personal or shared. Choose Outline when you want a hosted cloud, desktop apps or its integrations, and a database-backed wiki is acceptable. On enterprise sign-in Folio is ahead: both support OIDC, but Folio includes SAML, SCIM, groups synced from the identity provider and the audit log without a licence, and Outline does not offer SCIM or IdP group sync.
Try it with one real workflow
- Export one real collection from Outline as Markdown.
- Put the files in a folder of a Git repository and create a Folio space by cloning it. Folio has no Outline importer.
- Check file names (Folio file names are lowercase Latin letters, digits and hyphens), links and attachments.
- Edit one page in the browser and one in an IDE, and confirm both reach Git.
- Give one agent read-only MCP access and ask it a question the wiki can answer.
Sources (36 links, checked October 5, 2026)
- Outline LICENSE (BSL 1.1)
- Outline license restrictions
- Outline hosting requirements
- Outline file storage
- Outline Business and Enterprise editions
- Outline cloud pricing
- Outline authentication providers (OIDC)
- Outline SAML
- Outline users and roles
- Outline groups
- Outline collections and permissions
- Outline audit log
- Outline formatting and Markdown
- Outline collaborative editing
- Outline revision history
- Outline tables
- Outline diagramming
- Outline data attributes
- Outline GitHub integration
- Outline GitLab integration
- Outline MCP
- Outline AI answers
- Outline API
- Outline OAuth provider
- Outline webhooks
- Outline self-hosted integrations
- Outline import
- Outline Confluence importer
- Outline export
- Outline document export (PDF)
- Outline mobile
- Outline macOS app
- Outline Windows app
- Folio features
- Folio limitations
- Folio MCP and REST
Other comparisons
Try Folio with one real team wiki.
Clone it, run it, and test the workflow with your own files.