Carnetio documentation

Everything you need to write, organize and share in Carnetio. For the API and the MCP server, see the API reference.

Getting started

Sign up to create a workspace. It comes with a General teamspace and a Getting started page. Invite people from Settings → Members : with email set up they get a link by email, otherwise you copy the link.

Press ⌘K to search and run commands, ⌘⇧N for a new page, and ? to see every shortcut.

Writing

  • / opens the block menu : headings, to-dos, toggles, callouts, quotes, tables, columns, code, equations, images, video, files, bookmarks, embeds, databases, synced blocks, buttons.
  • Markdown shortcuts : # ## ###, -, 1., [] to-do, > toggle, " quote, ``` code, --- divider.
  • @ mentions a person, a page, a date or a reminder. [[ links a page or creates one. : inserts an emoji.
  • Select text to format it, color it, link it or comment on it (⌘⇧M).
  • The ⋮⋮ handle left of each block moves it by drag, and its menu deletes, duplicates, turns into, colors, links or comments the block.

Several people can edit the same page at once and see each other's cursors.

Pages

Add an icon and a cover from the top of a page. The ⋯ menu sets the font, small text and full width, locks the page, verifies it, shows analytics, exports it (Markdown, HTML, PDF) and moves or duplicates it. The clock shows the version history; restore any version.

Databases

A database is a set of pages with properties, shown as a table, board, gallery, list, calendar, timeline or chart. Each view keeps its filters, sorts, grouping and visible properties.

  • 22 property types : text, number, select, multi-select, status, date, person, files, checkbox, URL, email, phone, formula, relation, rollup, created and edited time and by, ID and button.
  • Formulas use Notion's syntax, for example prop("Price") * prop("Quantity"). The formula editor lists every function.
  • Relations link databases (both ways if you want); rollups count, sum or average across them.
  • Row templates, bulk edits, column calculations and CSV export are in the view toolbar and menus.

Sharing

Share gives people, teamspaces or the whole workspace full access, edit, comment or view rights. Invite an outside person by email as a guest : they see only what you share. Restrict a page to stop it inheriting access. The Publish tab puts a page on the web at /p/….

Comments and inbox

Comment on a whole page or on selected text. Mention people with @, react, resolve and re-open. Everything that concerns you lands in the inbox : J/K to move, E to archive, snooze for later.

Calendar, forms and automations

The calendar gathers dated rows across databases : drag to reschedule, click a slot to add a row, subscribe with the .ics link. Forms (database ⋯ menu) turn answers into rows, publicly or for members only. Automations set properties, add rows, notify people or call webhooks when rows change or on a schedule.

Import and export

Import a Notion export (Markdown & CSV zip, with sub-pages and files), Markdown, HTML or CSV files from the sidebar's Import. Pages, databases, rows, images and links between pages are kept. Export a page, a database as CSV, or the whole workspace from Settings → Import & export.

Keyboard shortcuts

⌘KSearch and commands
⌘⇧NNew page
⌘\Toggle the sidebar
⌘⇧LLight or dark theme
⌘[ / ⌘]Back / forward
⌘⌥LCopy the page link
G then H / I / C / SHome, inbox, calendar, settings
⌘DDuplicate block
⌘⇧↑ / ↓Move block
⌘⌥1 / 2 / 3 / 0Heading 1 / 2 / 3 / text
⌘⇧MComment

The mobile app

Carnetio installs on your phone as an app with its own icon.

  • Android (Chrome) : open Carnetio, then tap Install Carnetio.
  • iPhone (Safari) : tap Share, then Add to Home Screen.
  • Desktop (Chrome, Edge) : click the install icon in the address bar.

Plans

Free covers 3 members and 1,000 blocks. Pro and Business add unlimited blocks, guests, automations, the API, longer history and bigger uploads. Payment is arranged with the Carnetio team; your plan and renewal date show in Settings → Plan & usage. A plan that ends keeps working for 14 days, then the workspace becomes read-only until it is renewed. Nothing is deleted.

Self-hosting

Carnetio is one container (Next.js and the live-editing server) and a Postgres database :

docker compose -f docker-compose.prod.yml up -d

Set APP_URL, APP_SECRET, ADMIN_EMAIL and ADMIN_PASSWORD, and let your proxy pass WebSocket upgrades. The admin panel at /admin manages workspaces, plans and payments.

API reference →