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 New Topic.

  3. Replace "Untitled" with your topic title.

  4. Start writing in the editor below the title.

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

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 has a type that indicates its purpose:

  1. Open the topic and click the type dropdown in the properties panel.

  2. Choose a type:

    • Concept — explanations, overviews, background information

    • Task — step-by-step procedures

    • Reference — API docs, configuration tables, glossaries

    • Custom — anything that doesn't fit the above

Topic type is metadata for your team's workflow — it doesn't change how the topic renders. See Topic types for guidance on when to use each type.

Change topic status

  1. Open the topic and find the status dropdown.

  2. Select a status:

    • Draft — work in progress

    • 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, Review, Published), Content health indicators (stale, empty, orphaned, broken refs, undefined vars), or a combination

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

Use the content health filter to quickly find topics that need attention — orphaned topics not included in any map, stale topics that haven't been updated recently, or topics with broken references.

Delete a topic

  1. Open the topic.

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

  3. Select Delete topic and confirm.

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.

If the topic is referenced in maps, you'll see a warning. Removing a topic from all maps before deleting is recommended.

Export a topic

  1. Open the topic.

  2. Click the three-dot menu.

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

See also

Was this page helpful?