Skip to main content

Creating a New Page or Folder

When you navigate to the Knowledge Base tab, you’ll see a brand new Knowledge Base where you can start creating new folders and pages. On the left-hand side is your navigation panel. To create content:
  1. Right-click on the root or any folder to see options
  2. Select Create Page or Create Folder
  3. Enter a name for your content
  4. Start editing (if creating a page)

Folder Structure

You can create a hierarchical folder structure with a maximum of 3 folder levels deep. Within folders you can create as many pages as you want. Important naming rules:
  • ❌ You cannot have multiple folders with the same name in the root directory
  • ❌ You cannot have multiple pages with the same name within a folder
This organizational approach keeps your Knowledge Base clean and prevents naming conflicts.

Creating Pages

When you create a new page, you have two options:
  1. Write manually - Use the markdown editor to type and format your content
  2. Upload a file - Import existing documentation (see supported formats below)

Supported File Formats for Upload

The Knowledge Base supports uploading:
  • Text files (.txt)
  • Markdown files (.md)
  • Excel spreadsheets (.xlsx)
  • CSV spreadsheets (.csv)
PDFs and images are not currently supported file types. For PDFs and complex documents with images, use project file uploads instead.
When you upload a file, it will automatically be named with the name of the file you uploaded and converted to markdown format.

Markdown Editor

The page editor provides a markdown editor with live preview. You can:
  • Write your content in markdown
  • See a live preview of your changes
  • Format text, create lists, add headers, and more
  • Save your changes when ready

Key Information About Pages

The first 250 characters of your page are especially important. Orion uses this text to quickly understand what the page contains, so it’s recommended to:
  • Place a summary or description at the very top of the page
  • Provide the most important context in those first 250 characters
  • Think of it like an executive summary

Editing & Managing Pages

To edit a page:

  • Click on the page in the left navigation to open it
  • Click the Edit button in the top right corner
  • Make your changes and save

To rename or delete:

  • Right-click on a page or folder
  • Select Rename or Delete
If you try to delete a folder that contains pages, you’ll get a warning. You must first move the files out of that folder before it can be deleted. This is a safety precaution to prevent accidentally deleting entire folders of content.

Organizing Your Knowledge Base

You can reorganize your Knowledge Base by dragging and dropping pages or folders into one another. This makes it easy to reorganize your wiki pages without having to recreate them.

Revision History

We store the revision history of all your pages. In the top left corner above the editor, you can see who updated the page last and when. This helps track changes to your knowledge base over time.

Enabling Pages for Projects

To use Knowledge Base pages in a project:
  1. Go to your project settings
  2. Navigate to the Knowledge Base tab
  3. Search for and select the pages you want to enable
  4. Orion will have access to these pages when working on the project
By default, Orion has no access to knowledge base folders and files until you explicitly provide access by enabling them within the project. This keeps Orion focused on only the context needed for that specific project.