← All posts
Knowledge ManagementNovember 12, 2026

Notes, a canvas, and profiles with sources: arranging what you read

Your own notes with [[wiki links]] and backlinks, a canvas to lay out pages, sources and deadlines, and profiles whose fields are filled only from your sources. One rule holds them together: your own words are framing, not evidence, until you say otherwise.

In short

Pith offers three ways to arrange what you read: Markdown notes with [[wiki page]] links, @client links and backlinks; a canvas of cards for wiki pages, sources, highlights, deadlines, notes and free text that can become a briefing or a client update deck; and page types (regulation, company, product, person, topic) whose fields are filled only from the page's sources, each with a citation. A note never counts as evidence unless you choose 'Use as source'; on a canvas only source cards count as evidence.

S

Stefan Hartmann

Builds Pith

Notes, a canvas, and profiles with sources: arranging what you read

Pith now gives you three ways to arrange what you read: your own notes, a canvas to lay things out, and profiles — wiki pages with typed fields such as "applies from" or "vendor", each value filled from your sources with a citation. One rule holds them together: what you write yourself is framing, what your sources say is evidence, and Pith treats your own words as evidence only when you explicitly say so.

So far Pith was built for one direction: from sources to the wiki. You saved what you read, and the LLM wiki grew from it, every paragraph with its citation. What was missing was the other direction, your own thinking. Where do you write down that two clients face the same question? Where do you put ten pages into the order you want to present on Thursday?

Why does a reading memory need your own notes?

Because reading is half the work. The other half is what you make of it: a hunch, a connection, a question for the next client call. If that lives in a separate tool, it is cut off from the sources it is about.

Notes in Pith are plain Markdown. You link to a wiki page with [[Page name]], and an autocomplete suggests pages as you type. You link to a client with @client. Wiki pages, saved sources and clients then show "Notes that mention this": the backlinks from your notes. Notes are searchable, like the rest of your workspace.

Your AI assistant can read and write notes over MCP. Claude can turn a conversation into a note, or read what you wrote about a client before a meeting. And notes export as Markdown files with front matter, so they stay usable outside Pith.

If you have used Obsidian or Roam, [[links]] and backlinks will feel familiar. We borrowed the pattern because it works.

When does a note become evidence?

Never by accident. That is the most important design decision in this release.

A note is your text. A wiki that quietly cited your hunches as if they were sources would lose the property that makes it useful: every claim leads to something you read. So a note stays a note until you choose "Use as source". Pith then stores a snapshot of it as a source without a web address. It is never re-fetched, because there is nothing to fetch. On a wiki page it is cited as "Your note of 1 November 2026", not as a domain. Notes used as sources are never shown on public pages.

This is for the things you know first-hand: what a client said in a workshop, the result of your own analysis. They can enter the wiki, clearly marked as yours.

What is the canvas for?

A wiki is organised by subject. Work often is not. For a client update you may need six pages, two highlights, a deadline and a sentence of your own, in an order that makes an argument.

The canvas is a free surface for that. A card can be a wiki page, a saved source, a highlight, a deadline, a note or free text. You connect cards with labelled arrows ("drives", "contradicts", "affects this client") and put related ones into groups. Every card shows how many sources back it, so a well-supported page and a thin one look different at a glance.

If you know Heptabase or Obsidian's canvas, the idea will be familiar. The source count on every card is what makes it useful for work that has to hold up in front of a client.

How does a canvas turn into a briefing or a deck?

From a canvas you can create a briefing or a client update deck, in the order you arranged the cards. The same rule applies as for notes: only source cards count as evidence. Free text and notes are framing. They shape the order and the argument, but no claim in the result rests on them. If a slide states a fact, it cites a source you saved.

You can also export a canvas as JSON Canvas, an open format that several tools read, so your layout is not locked into Pith.

What is a profile?

Some pages are about a particular kind of thing: a regulation, a company, a product, a person. For these it helps to have the same few facts in the same place every time. Pith now has page types, and each type has its fields:

  • Regulation: in force since, applies from, authority, who is covered, penalties
  • Company: sector, HQ country, relation to clients
  • Product: vendor, category, launched
  • Person: role, organisation
  • Topic: no fields; the type only labels the page

Fields are filled only from the page's own sources. Each value carries a citation and goes through the same check as the page text. If the sources do not state a value, the field stays empty. An empty field is information; a guessed one is a risk. When you edit a field yourself, it is locked, and later updates leave it alone.

Dates keep the precision of the source. If a source says a product launched in "1996", the field says 1996, not 1 January 1996; "May 2026" stays May 2026. An invented day of the month is a small fabrication, and small fabrications are the ones that get copied into client documents.

One field is not read from sources at all. Relation to clients on a company page is computed from your own client links: it shows the clients whose tagged sources stand behind the page.

How do you ask across profiles?

Once pages have fields, you can ask across them. A question like "What applies from 2027?" is turned into filters before it runs — page type regulation, "applies from" in 2027 or later — and you see those filters. If the question was understood wrongly, you notice and adjust it, instead of trusting an answer built on a misread question.

The same kind of query is available to your assistant over MCP as query_pages. Claude can ask which companies in your wiki have their headquarters in Germany and get pages with cited field values back, not a guess from its training.

What does it cost?

Writing notes and arranging a canvas are your own work. Where an AI step is involved, such as filling fields or creating a briefing or a deck from a canvas, the price is listed on the pricing page.

What stays the same?

Notes, the canvas and profiles make room for your own thinking. They do not loosen the rule that holds the wiki together: a claim counts as evidence only when it leads to a source. Your notes can frame, connect and question, and they become a source only when you decide they should.

More on how this fits together: the wiki, clients, and why we start from citations in Every claim cites its source. Deadline cards on a canvas come from your sources, as described in Deadlines from your sources.

FAQ

Can my notes end up as evidence in the wiki by accident?

No. A note stays a note until you choose 'Use as source'. Then Pith stores a snapshot of it as a source without a web address, which is never re-fetched and is cited as 'Your note of <date>'. Notes used as sources are never shown on public pages.

What counts as evidence when I create a briefing from a canvas?

Only source cards. Wiki pages, saved sources, highlights and deadlines bring their citations along; free text and notes on the canvas shape the order and the argument, but no claim in the output rests on them.

What happens when a source does not state a field's value?

The field stays empty. Fields are filled only from the page's own sources, each value with a citation and checked like the page text. A field you edit yourself is locked, so later updates do not overwrite it.

Can I take my notes and canvases out of Pith?

Yes. Notes export as Markdown files with front matter, and a canvas exports as JSON Canvas, an open format that several tools read.

Can my AI assistant use notes and profiles?

Yes, over MCP. An assistant such as Claude can read and write your notes, and the query_pages tool lets it ask across page fields, for example which regulations apply from 2027, and get back pages with cited values.

Related