Skip to content

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.

Folio vs. Outline: operating-model comparison
AreaFolioOutline
Source of truthMarkdown, table and board files in your Git repositoryDocuments in PostgreSQL; attachments in S3-compatible storage or on local disk
LicenseMITBusiness 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
HostingSelf-hosted with Docker: the app, PostgreSQL and Redis. No hosted versionHosted cloud, or self-hosted with Docker, PostgreSQL 14+ and Redis 4+
PriceFree software; you pay for your server and any AI subscription you connectCloud: $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 limitsPlusOne MIT edition: SSO, SCIM, groups and the audit log are all in itSelf-hosted community edition has no SAML, audit log, Confluence importer, PDF export, AI answers or guest role; the licensed edition (Business) adds them
EditingReading, live edit and source modes over plain MarkdownRich-text editor that converts typed or pasted Markdown; slash commands, templates, comments
Git workflowGit is the live content history; IDE edits sync backNo Git-backed storage; GitHub and GitLab integrations preview issues, pull requests and merge requests
HistoryGit commits with the editor as authorRevisions at least every five minutes, with diff and restore
CollaborationReal-time documents, tables and whiteboardsReal-time editing with cursors and observer mode, comments and threads
Structured data and diagramsTyped data tables and forms as Markdown files; Mermaid and Excalidraw boardsTables in documents with CSV export; Mermaid and diagrams.net; document properties in licensed editions (preview)
AgentsBuilt-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 basesMCP server with OAuth or API key to search, read, create and edit documents; AI answers through OpenAI in cloud and licensed editions
API and integrationsREST API with personal access tokens; MCP with tokens or OAuth 2.1Documented API with scoped keys, OAuth provider, webhooks; integrations include Slack, GitHub, GitLab, Linear, Figma and Jira
Sign-inPlusEmail 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
PermissionsPlusRoles 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 nestedCollection 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 sessionsPlusAudit log screen with CSV export. Sign out other devices; deactivating a person revokes their sessions, API tokens and MCP connectionsAudit log in licensed editions only
Migration inConfluence importer; no Outline importerImports Confluence (cloud and licensed editions), Notion, Word, Markdown, HTML and text files
Migration outThe repository already holds the files; export md, pdf, docx, yaml or a zip of a spaceMarkdown, HTML or JSON per collection or workspace; PDF only in cloud and licensed editions
AppsResponsive web interface; no native appDesktop apps for macOS and Windows; no native mobile apps, installable as a PWA
Try itPublic demo at demo.foliowiki.online (shared login, resets every 24 hours); or run it yourself with docker compose30-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.

Try Folio with one real team wiki.

Clone it, run it, and test the workflow with your own files.