Skip to content

Create and manage topics

Topics are the atomic content units in Topicary. Each one covers a single concept, task, or reference entry.

Create a topic

  1. Go to Topics in the sidebar.

  2. Click Create topic (or press N on the Topics page).

  3. Replace "Untitled" with your topic title.

  4. Start writing in the editor below the title.

If the project has any Use topic templates, Create topic opens the template picker first. If it has none, it creates a blank topic directly.

The editor auto-saves 1 second after the last keystroke. The header shows a "Saving..." then "Saved" indicator.

Auto-save is always active. You never need to manually save. Just keep writing and Topicary handles the rest.

Set the topic type

Each topic can have a type that indicates its purpose:

  1. Open the topic and, in the properties panel, click Add type (or the existing type value to change it).

  2. Type a type name or pick one from the autocomplete, for example, guide, reference, concept, or task. The field is free text, so you can use any type your team standardizes on. Suggestions come from types already used in the project.

Topic type is metadata that drives your team's workflow and the schema.org markup applied at publish time. It does not change how the topic renders in the editor. See Topic types for guidance on when to use each type.

Change topic status

  1. Open the topic and find the status control in the properties panel.

  2. Select a status:

    • Draft: work in progress

    • In review: ready for feedback

    • Published: finalized and approved

Status badges appear on the topics listing page for quick scanning. See Content statuses for more on how statuses fit your workflow.

Filter and sort the topics list

On the Topics page:

  • Filter by status (Draft, In review, Published), topic type, Content health indicators (stale, empty, orphaned, broken refs, undefined vars), or last-modified time

  • Sort by name (A-Z, Z-A), last updated, or status

Use the content health filter to quickly find topics that need attention. Examples include orphaned topics not included in any map, stale topics that have not been updated recently, and topics with broken references.

Rename a topic

Edit the title directly in the editor, or, on the Topics list, open a row's three-dot menu and select Rename.

Delete a topic

From the editor: open the topic, click the three-dot menu in the header, and select Delete topic.

From the Topics list: open a row's three-dot menu and select Delete.

Confirm when prompted. The confirmation reads "The topic will be permanently deleted and removed from all maps."

Deleting a topic is permanent. If the topic is referenced in Create and organize a map or used as a How component reuse works, those references will break. Remove the topic from all maps before deleting.

Export a topic

  1. Open the topic.

  2. Click the three-dot menu in the editor header.

  3. Select Export as Markdown to download the topic as a .md file.

See also

Was this page helpful?