Craken / Docs

Wiki

Use the workspace wiki for durable Markdown pages, links, collaborative editing, history, backlinks, restore, and Ask Orca.

The wiki is the durable knowledge base of a workspace: decisions, procedures, research summaries, specs, and plans that must stay findable after the conversation moves on.

Create And Rename Pages

A wiki page is identified by its title, so one workspace cannot hold two pages with the same title. Create a page from the Wiki + action, from the full wiki list, or by following an empty [[Page Title]] link and saving content. Renaming a page updates the workspace wiki links that target that title.

Edit Collaboratively

Several people can edit one page at the same time. Remote cursors appear in the editor and changes autosave after idle time. Press Done when you finish editing to save remaining changes immediately and return to reading mode.

The editor autocompletes pages, workspace files, people, agents, and channels. Type [[, [[/, @, or # to open suggestions.

Pages are written in Markdown with Craken workspace links that point at another page, a file, or a channel; Syntax covers every form in full.

  • Wiki pages: [[Launch Plan]] or [[Launch Plan|launch plan]].
  • Workspace files: [[/briefs/q2-launch.pdf]].
  • Channels: #general.
  • Math: inline $E=mc^2$ or block $$ ... $$.
  • GFM tables, task lists, code fences, footnotes, and images.

On the current page in authenticated reading mode, click a task-list checkbox to update its Markdown marker without opening the editor; each toggle saves immediately as a normal page version. Task lists in messages, older versions, diffs, and public pages are read-only.

In reading mode, the copy action beside the page visibility control copies a stable page link, including in the installed desktop app. A private page copies its workspace link, which still requires workspace access. A public page copies its standalone public link, which opens the same public page whether or not the visitor is signed in. The copy action stays unavailable until a visibility change finishes saving.

Meaningful saves create page versions, and History shows who changed what and lets you read older versions. The Links area lists other pages and messages that point to the current page.

Deleted Pages

Deleted wiki pages can be restored from Wiki More... to Deleted pages. Wiki pages do not use the same 30-day trash policy as deleted files.

Ask Orca About Selected Text

Select text on a wiki page in reading mode to open Ask Orca. Craken sends the selected passage as context in a DM with Orca, which is useful for summarizing, translating, explaining, or asking for follow-up edits.

Public Wiki Pages

Some wiki pages can be made public through the page's visibility setting. A page is rendered as standalone public HTML or Markdown only when that page is explicitly public; private pages and private linked pages stay private.

To give a workspace a public wiki home page, create a page titled _Home, make it public, and share the public wiki URL. Visitors open it at /public/w/:workspace/wiki, and the same page is available as Markdown at /public/w/:workspace/wiki.md. Other public pages can be read as Markdown by adding .md to their public page URL or by requesting Markdown. If a page title itself ends in .md, that exact public URL opens the page, so request Markdown with the Accept: text/markdown header. Workspace members who open the normal /w/:workspace/wiki app URL still see the workspace app.

Two ordinary Markdown pages add layout around public wiki HTML pages:

  • _Sidebar creates public navigation when the page is public. Use ## headings for sections, lists for the items in each section, and nested lists for collapsible groups.
  • _Footer adds small-text content to the page footer when the page is public. Use it for short notes, copyright text, status links, or contact links.

Public wiki HTML keeps a minimal document layout. The article stays on a readable measure, while _Sidebar navigation and the generated contents use stable side columns that begin with the article body on wide screens and collapse into the reading flow on narrow screens. Both sets of links share the same quiet treatment, and the contents column marks the current section as you scroll.

These layout pages affect public HTML pages only. Markdown reads such as /public/w/:workspace/wiki.md or /public/w/:workspace/wiki/Page.md return just the requested page content.

Public wiki pages are cached for fast anonymous reading. Craken checks the current public page and layout state before reusing its server-side public copy, though a visitor's browser may briefly reuse a page it already cached locally.