# Foliosodev docs > Folioso is a lightweight knowledge base for developers: rich-text notes, syntax-highlighted code, diagrams, images and easy sharing in one web app. This page ex... ## Getting started - [Introduction](https://docs.folioso.dev): Folioso is a lightweight knowledge base for developers: rich-text notes, syntax-highlighted code, diagrams, images and easy sharing in one web app. This page ex... - [Quick start](https://docs.folioso.dev/getting-started/quick-start): Create your Folioso account, set up your organisation and write your first page in a few minutes. This page walks through registration, the plan step and what y... - [Key concepts](https://docs.folioso.dev/getting-started/key-concepts): Folioso is built from a few simple pieces: organisations, spaces, groups, pages, teams and roles. This page explains each one and how they decide who can see an... - [Finding your way around](https://docs.folioso.dev/getting-started/navigating): A tour of the Folioso interface: the sidebar, the organisation and space switcher, the All Pages list, the page header and the command palette. Use it to find w... ## Writing pages - [Creating and managing pages](https://docs.folioso.dev/editor/pages): Pages are where you write in Folioso. This page covers creating a page, how saving works, and how to rename, nest, favourite, duplicate, move and delete pages. - [Formatting text](https://docs.folioso.dev/editor/formatting): Format text in the Folioso editor with the toolbar, keyboard shortcuts or Markdown-style typing. This page covers text styles, headings, lists, quotes, links, a... - [Code blocks](https://docs.folioso.dev/editor/code-blocks): Code blocks hold syntax-highlighted code with line numbers, a language picker and a copy button. This page covers inserting them, choosing a language, indenting... - [Diagrams](https://docs.folioso.dev/editor/diagrams): Draw flowcharts, sequence diagrams and more by writing Mermaid or PlantUML source, and Folioso renders the picture on the page. This page covers inserting a dia... - [Alert boxes](https://docs.folioso.dev/editor/alerts): Alert boxes are titled, coloured panels for the things a reader mustn't miss: a tip, a success, a warning or an error. This page covers inserting them, changing... - [Images](https://docs.folioso.dev/editor/images): Add screenshots and pictures to a page by uploading, pasting or dragging them in, then resize, align and caption them in place. This page covers adding images,... - [Page links and mentions](https://docs.folioso.dev/editor/links-and-mentions): Link to another Folioso page by typing #, and tag a colleague by typing @. This page covers both pickers, what readers see, and who gets notified. - [Tags](https://docs.folioso.dev/editor/tags): Tags are coloured labels you put on pages, such as python or incident, so related pages are easy to spot. This page covers adding tags to a page, creating and m... - [Editing together](https://docs.folioso.dev/editor/collaboration): When several people open the same page, Folioso keeps everyone's screen in sync as they type, with live cursors and faces in the header. This page explains when... - [Version history](https://docs.folioso.dev/editor/version-history): Version history keeps snapshots of a page, taken every night it changes and whenever you take one by hand, so you can look back at an earlier version and restor... - [Exporting pages](https://docs.folioso.dev/editor/exporting): Export a page as a PDF to send or print, or as a Markdown file to use in a repository or another tool. This page covers both, who can export, and what each form... - [Keyboard shortcuts](https://docs.folioso.dev/editor/keyboard-shortcuts): Every keyboard shortcut in Folioso, grouped by where you use it. On a Mac, use ⌘ (Command) where the tables say Ctrl, and Option where they say Alt. ## Spaces - [About spaces](https://docs.folioso.dev/spaces/overview): Spaces are the main way to organise pages and control who can see them in Folioso. Each space holds its own groups, pages and tags, and has an access type that... - [Creating and managing spaces](https://docs.folioso.dev/spaces/creating-and-managing): Organisation admins create, rename and delete spaces. Space admins and organisation admins manage a space's access type, logo, people and teams from the Spaces... - [Groups](https://docs.folioso.dev/spaces/groups): Groups are flat folders that sort the pages inside a space. Each group has a name, a colour and an optional icon and description, and appears as a collapsible s... - [Roles and permissions](https://docs.folioso.dev/spaces/permissions): Your role in a space decides what you can do with its pages and groups. There are three roles, Viewer, Editor and Admin, and a page can also be made private so... - [Requesting access](https://docs.folioso.dev/spaces/access-requests): Members can ask to join a closed space, and the space's admins approve or decline the request. This page covers both sides: asking for access and answering requ... - [Space activity](https://docs.folioso.dev/spaces/activity): The activity feed shows what has happened to the pages in a space: who created, edited, shared, deleted, restored or permanently deleted them, newest first. - [Recycle bin](https://docs.folioso.dev/spaces/recycle-bin): Deleted pages go to a recycle bin, where they can be restored for 30 days before they're permanently removed. There's your own recycle bin, and an organisation-... ## Search and sharing - [Search](https://docs.folioso.dev/sharing/search): Search finds pages by their title and content across every space you can open in the current organisation. It runs from the command palette, which you open with... - [Sharing with people](https://docs.folioso.dev/sharing/sharing-with-people): Share a single page with someone by email, as read-only or as an editor. They don't need to be in your organisation, and if they don't have a Folioso account ye... - [Public links](https://docs.folioso.dev/sharing/public-links): A public link lets anyone with the URL read a page, without an account. You can make the link view-only or let signed-in people edit, protect it with a password... - [Shared with you](https://docs.folioso.dev/sharing/shared-pages): Three lists in the sidebar keep track of sharing: pages shared with you, pages you opened from public links, and pages you've shared yourself. Find them under S... - [Notifications](https://docs.folioso.dev/sharing/notifications): Folioso tells you when something needs your attention: a page shared with you, a mention, or a request to join a space you look after. Some notifications appear... ## Your organisation - [Organisation overview](https://docs.folioso.dev/organisation/overview): The organisation hub is where organisation admins run the organisation: its name and logo, members, teams, spaces, billing, uploads, the recycle bin, the audit... - [Organisation settings](https://docs.folioso.dev/organisation/settings): The Settings tab is where organisation admins change the organisation's name, web address and branding, and reach single sign-on, email domains, automatic suspe... - [Members and invitations](https://docs.folioso.dev/organisation/members): Organisation admins invite people by email, track pending invitations and manage everyone in the organisation from the Members tab. - [Admins and ownership](https://docs.folioso.dev/organisation/roles-and-ownership): Every member of an organisation is an admin or a member, and one admin is the owner: the billing contact who can't be removed until they hand the organisation o... - [Suspending members](https://docs.folioso.dev/organisation/suspending-members): Suspending a member takes away their access to the organisation without removing them, and frees their seat; you can suspend people by hand or automatically aft... - [Teams](https://docs.folioso.dev/organisation/teams): A team is a named group of members that you can grant a role on a space in one step, instead of adding each person separately. - [Managing spaces](https://docs.folioso.dev/organisation/managing-spaces): The hub's Spaces tab lists every space you manage, so you can set each one's access type, answer access requests and grant people and teams roles in one place. - [Verified domains](https://docs.folioso.dev/organisation/domains): Verify your company's email domain and anyone with a confirmed address on it can join your organisation as a member, without an invitation. - [Single sign-on](https://docs.folioso.dev/organisation/single-sign-on): Single sign-on lets your members sign in to Folioso through your own OpenID Connect identity provider, such as Google Workspace, Microsoft Entra ID or Okta. - [Audit log](https://docs.folioso.dev/organisation/audit-log): The audit log records who changed access, membership, sharing and settings in your organisation, so admins can answer "who did this, and when?" - [Uploads and storage](https://docs.folioso.dev/organisation/uploads): The Uploads tab shows every image in your organisation's pages and how much of your plan's image storage you've used. - [Former members' content](https://docs.folioso.dev/organisation/former-members-content): When someone leaves your organisation, their private pages and the pages in their personal space stay behind; organisation admins can take them over or delete t... - [Working in several organisations](https://docs.folioso.dev/organisation/multiple-organisations): One Folioso account can belong to several organisations, each with its own web address, spaces, plan and role for you; you switch between them from the sidebar. - [Deleting an organisation](https://docs.folioso.dev/organisation/deleting-an-organisation): Deleting an organisation closes it for everyone straight away and erases it permanently after a 30-day grace window, during which an admin can restore it from a... ## Plans and billing - [Plans](https://docs.folioso.dev/billing/plans): Folioso has four plans: Free, Pro, Team and Business. This page explains how plans work, the difference between flat and per-seat plans, and covers trials and o... - [Seats](https://docs.folioso.dev/billing/seats): A seat is a place for one member in your organisation. This page explains who takes a seat, how adding and removing people changes your seat count and bill, and... - [Choosing a plan](https://docs.folioso.dev/billing/choosing-a-plan): You pick your organisation's plan when you register, and an admin can change it at any time from the Billing page. This page covers both, and who is allowed to... - [Upgrading](https://docs.folioso.dev/billing/upgrading): Moving to a plan that costs more takes effect straight away, and you pay the difference only for what's left of the current billing period. This page explains h... - [Downgrading](https://docs.folioso.dev/billing/downgrading): Moving to a plan that costs less is scheduled for the end of your current billing period, so you keep what you've paid for until then. This page covers scheduli... - [Moving to the Free plan](https://docs.folioso.dev/billing/returning-to-free): You can move a paid organisation back to Free at any time. The move is scheduled for the end of your billing period, you can call it off until then, and nothing... - [Invoices](https://docs.folioso.dev/billing/invoices): Folioso issues an invoice for each paid billing period once it has closed. This page explains when invoices are issued, what they contain, how to download them... - [Billing details](https://docs.folioso.dev/billing/billing-details): Billing details say who your invoices are addressed to and where payment reminders go. This page explains each field and when changes take effect. - [Overdue payments](https://docs.folioso.dev/billing/overdue-payments): An invoice becomes overdue when its due date passes without full payment. Folioso then sends reminders, and if the invoice is still unpaid after a grace period,... ## Your account - [Signing in](https://docs.folioso.dev/account/signing-in): Sign in to Folioso with your email and password, with GitHub, or through your organisation's single sign-on, and keep your account secure with email verificatio... - [Profile and email](https://docs.folioso.dev/account/profile): Change your name, email address, profile photo and password from the Profile section of your account settings. - [Preferences](https://docs.folioso.dev/account/preferences): Choose a colour theme and set the defaults Folioso's editor uses for code blocks. Your preferences are saved to your account and follow you to every device. - [Two-factor authentication](https://docs.folioso.dev/account/two-factor-authentication): Two-factor authentication asks for a six-digit code from an authenticator app whenever you sign in with your password. It's optional for most people and require... - [API tokens](https://docs.folioso.dev/account/api-tokens): Create personal API tokens to use the Folioso REST API from scripts and integrations. Each token acts as you, in one organisation, with read-only or read-and-wr... - [Exporting your data](https://docs.folioso.dev/account/exporting-your-data): Download a copy of everything you've written in Folioso: every page you created, as Markdown, plus every image you uploaded, bundled into one ZIP file. - [Deleting your account](https://docs.folioso.dev/account/deleting-your-account): Deleting your account signs you out everywhere and schedules your account for permanent erasure after a 30-day grace window. Until then you can change your mind... ## Security and privacy - [Security overview](https://docs.folioso.dev/security/overview): How Folioso protects your account, your organisation's content and the pages you share: sign-in protection, two-factor authentication, sessions, public links, u... - [Data and privacy](https://docs.folioso.dev/security/data-and-privacy): What Folioso keeps, for how long, and how you can take your data with you or have it erased. ## REST API - [API overview](https://docs.folioso.dev/api/overview): The Folioso REST API lets scripts and integrations read your organisation's spaces, groups, tags and pages, search them, and create, update, move, tag and delet... - [Authentication and limits](https://docs.folioso.dev/api/authentication): Every API request is authenticated with a personal API token sent as a bearer token. Tokens are bound to one organisation, carry read or read-and-write abilitie... - [Pages](https://docs.folioso.dev/api/pages): List, search, read, create, update, move, tag and delete pages through the API. Pages are identified by their slug, and their content can be read and written as... - [Content formats](https://docs.folioso.dev/api/content-formats): A page's body can be read and written in two formats: TipTap JSON, the document format the editor stores, and Markdown, in a dialect that reads like ordinary Ma... - [Writing Markdown](https://docs.folioso.dev/api/markdown): Send a page body as Markdown in the markdown field and Folioso converts it into the same content the editor makes. This page lists every piece of Markdown that'... - [Folioso Markdown extensions](https://docs.folioso.dev/api/markdown-extensions): Folioso Markdown is ordinary Markdown plus a few extensions that carry what plain Markdown can't: page links, mentions, underline, alignment and other attribute... - [TipTap JSON reference](https://docs.folioso.dev/api/tiptap-json): A page's body is stored as a TipTap JSON document, the format the editor itself saves. This page describes every node, mark and attribute the editor uses, with... - [Images](https://docs.folioso.dev/api/images): Upload an image through the API, then use it on a page you create or update. An upload doesn't need a page, so you can upload first and create the page that sho... - [Spaces, groups and tags](https://docs.folioso.dev/api/spaces-groups-and-tags): Read the spaces you can reach, and the groups and tags inside them, so you know where to file pages and how to filter them. These endpoints are read-only and ne... - [Recycle bin and snapshots](https://docs.folioso.dev/api/recycle-bin-and-snapshots): Read the pages in your recycle bin, and list, read and take snapshots of a page. These endpoints read what the app's recycle bin and version history show. Resto... - [API examples](https://docs.folioso.dev/api/examples): Four complete workflows: creating a page from Markdown you've written, editing a page as Markdown and writing it back, uploading an image and using it on a page... - [Errors](https://docs.folioso.dev/api/errors): The API always answers in JSON, including errors and unknown addresses. Every error body has a message, and validation errors add an errors object naming each f... ## Help - [Frequently asked questions](https://docs.folioso.dev/help/faq): Short answers to the questions people ask most about accounts, plans and billing, sharing, security and your data, with links to the full details. - [Troubleshooting](https://docs.folioso.dev/help/troubleshooting): Fixes for the most common problems, grouped by what you're seeing. Each one explains the likely cause and what to do about it.