How to use these docs

This folder is the complete user documentation for Operon. It is written to be read three ways: inside Obsidian, as a downloaded folder, or by an AI assistant. Pick whichever fits how you work.

Get these docs inside your vault

Operon can download the official docs directly into your vault. Open Settings → Operon → Core → General, find Operon Docs, and choose Download / update docs. Operon writes the docs into Operon/Docs as normal Markdown files, so you can browse them with Obsidian links, search, graph view, or an AI assistant.

If you want Operon to refresh the docs after plugin updates, enable Automatically update Operon Docs in the same section. Only managed DOCS-*.md files are overwritten. If you want to edit a docs page for your own notes, copy it somewhere else first.

Read it inside Obsidian

Open Operon Docs MOC and follow the Start here path. The pages link to each other with normal Obsidian links, so you can click through related topics and use graph view to see how features connect. This is the best way to learn Operon step by step.

MEDIA-DOCS-002-1: The Operon Docs folder open in Obsidian.

MEDIA-DOCS-002-1 - Operon Docs folder in Obsidian

Read it as a downloaded folder

The folder is self-contained. You can copy it out of your vault, keep it anywhere, and read the files as plain Markdown in any editor. Every page is written to make sense on its own, so you do not need Obsidian to understand it.

Ask an AI assistant about Operon

Because every page is plain text that stands on its own, you can hand the whole folder to an AI assistant and ask questions about Operon: how a feature works, which approach fits your case, or how to fix a problem.

A good way to do this:

  1. Give the assistant this folder (or the files relevant to your question).
  2. Ask in plain language, for example:
    • "I have a lot of small to-dos and a few big projects. Should I use inline tasks or file tasks?"
    • "How do I make a task repeat every Monday?"
    • "My tasks are not showing up in the Calendar. What should I check?"
  3. Start from Getting started with Operon and Operon system map if you want the assistant to understand the big picture before the details.

What these docs cover

These docs are for using Operon. They do not cover building or contributing to the plugin. Operon changes between releases, so if a detail does not match what you see, your version may be newer or older than when a page was last updated; each page carries its own update date.