Project Structure

Each project has a tree structure, similar to the Documents folder on your computer. This allows you to organize your notes on your world in whatever way you like.

Every new project has some default folders and notes to get you started.

Default project structure

Above is the project overview. It shows you the folders and notes in your project. To expand or collapse a folder, click the arrow next to it. If you're using the mobile app, you can access this using the button in the top left corner. On desktop, it is permanently shown on the left of the screen.

To add an item, press the "plus" button at the bottom of the project overview. You will get a window that looks like this:

New Item window

Choose the type of item by clicking the dropdown box, then choose a name for the item. Click "Add" to add the item to the currently selected folder.

To remove an item, simply select it and then click the "minus" button at the bottom of the project overview.

Types of Items

openworldcrafter provides several types of notes for organizing different information about your world.


To enter Edit Mode, click the Edit button in the top right corner (bottom right on mobile):

Edit button

Edit Mode allows you to add notes, attachments, and other details to the items in your project. You can also rename objects using the Name field at the top:

Name editor

To save the changes you've made, click the Save button, also in the top right corner:

Save button

Remember to save your work often!

Notes and Characters

Notes are the most basic items in a project. Use them to keep track of different aspects of your world. Each note can hold text, as well as other notes.

Characters are a special type of note that has two extra tabs: Relationships and Character Sheet. These tools can help you keep better track of your characters.

Markdown Formatting

The Markdown editor allows you to format your notes. You can use bold and italic, insert tables, lists, and bullet points, and even add emoji.

This document outlines the Markdown editor toolbar. If you would like to learn the raw syntax, go to the syntax documentation.

Bold, Italic, and Strikethrough

These buttons are straightforward. The three buttons on the left are, in order, bold, italic, and strikethrough.


There are three levels of headers in the editor. Use the next three buttons to add one of these headers.

Header 1

Header 2

Header 3


Quotes are paragraphs shown with extra indentation, like this:

"Not every quote on the Internet is true, or even attributed to the right person." -- Albert Einstein

Use the quote button to add a quote.

Numbered and Bullet Lists

The Numbered List button inserts a numbered list, like this:

  1. Go to the castle
  2. Sneak into the kitchen
  3. Don't get caught
  4. Eat as much as you want

The Bullet List button inserts an unordered list.

  • Cats
  • Dogs
  • Fish
  • Rats


Click the Table button to add a table. By default, it will have two columns. It will look like this:

| Table Header | Table Header |
| Table Data   | Table Data   |

You can add more columns or rows by copying this style. For example, to add a column, you would add this:

| Table Header | Table Header | My Header |
| Table Data   | Table Data   | Table Data|

The table above will look like this when you leave Edit Mode:

Table Header Table Header My Header
Table Data Table Data Table Data


Most common emoticons are automatically converted into emoji. For example, :-) becomes 😃 and :/ becomes 😕.

For other emoji, click the Emoji button and choose the one you want to insert.


Items can link to other items in the project or to webpages on the Internet.

To create a link to a webpage, paste the URL into the editor, select it, and click the Link button. This will transform it into a link. External links will open in your browser when you click them.

To create a link to another item in your project, click the Link button. A search box will appear where you can search the project. Click on the object you would like to link, and the link code will be inserted.

Embed Videos

You can embed content from Youtube and Vimeo into your notes using the Embed button.

Markdown Syntax

Bold, Underline, and Strikethrough

To make text bold, put two asterisks or two underscores on each side. To make text italic, put one asterisk or one underscore on each side. To add a strikethrough effect, put two tildes on each side.


**This text is bold.**
_This text is italic._
**_This text is both!_**
~~This~~ That is how you do strikethrough.

This text is bold. This text is italic. This text is both! This That is how you do strikethrough.


There are two ways to create headers. The easiest is to add hashtags at the beginning of the line. Note that up to six levels of headers are used, even though the editor only has buttons for three of them.


# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

Header 1

Header 2

Header 3

Header 4

Header 5
Header 6


To make a paragraph a quote, start it with a greater-than sign.

> "Not every quote on the Internet is true, or
even attributed to the right
person." -- Albert Einstein

"Not every quote on the Internet is true, or even attributed to the right person." -- Albert Einstein

Numbered and Bullet Lists

Numbered lists are easy: simply start each item with the number, followed by a period. Note that Markdown automatically corrects the numbering when you leave Edit Mode.


1. Item A
2. Item B
2. Item C
5. Item D
  1. Item A
  2. Item B
  3. Item C
  4. Item D

Bullet lists are similar, but each item starts with a dash, plus sign, or asterisk.


- Cats
- Dogs
- Fish
  • Cats
  • Dogs
  • Fish


Most common emoticons are automatically converted into emoji. For example, :-) becomes 😃 and :/ becomes 😕.

For other emoji, write the name of the emoji between two colons.


I <3 openworldcrafter, but I need :coffee: to write :books:.

I ❤️ openworldcrafter, but I need ☕️ to write 📚.


Spoilers are hidden until you roll your mouse over them (or, on mobile, tap them). This can help prevent casual shoulder-surfing.


::: spoiler
Everybody dies at the end!

Everybody dies at the end!

Timelines and Events

Timelines are a special type of folder that can store notes on events chronologically. To add an event to a timeline, click the "plus" button at the bottom of the project overview, the same way you would create any other note.

Event Editor

Every event has a date and time associated with it. This is shown at the top of the event's page:

Date and time of an event (6 August 2017 13:59)

In Edit Mode, you can edit the date and time:

Date and time editor

Use the fields given to edit the day, month, and year.

Time Editor

Below the date fields are the time fields. The dropdown box allows you to choose between All Day, Exact Time, or a time of day. An event set to Exact Time has an hour and a minute, specified in 24-hour time for simplicity.

All Day removes the time altogether; use this for events that don't take place at a certain time, like birthdays or holidays.

The other options in the dropdown specify the time of day:

  • After Midnight
  • Sunrise
  • Early Morning
  • Late Morning
  • Noon
  • Early Afternoon
  • Late Afternoon
  • Evening
  • Sunset
  • After Sunset
  • Before Midnight
  • Midnight

If you choose one of these, it will be displayed in place of the hour and minute, like this:

6 August 2017 Noon


Timelines have an extra tab at the top called Calendar. Here, you can edit the names of the months as well as the number of days in each. This allows timelines to accommodate many alternate calendars that might appear in fantasy worlds. By default, it is set to a normal Gregorian calendar, with no leap days.



Attachments allow you to add images to your project. Attachments can be added to any item, and they have their own tab:

Attachments tab

To upload an attachment, enter Edit Mode and click "Upload". You will see a window that looks like this:

Upload window

You can either drag files from your desktop or folders into the blue box, or you can click "Choose Files" to find a file. You can add multiple files at once. When you have all the files you want to upload, click the "Upload" button to add the files to the project.

You can also add titles and captions to your attachments. This is what Edit Mode looks like for the Attachments tab:

Edit attachment title and caption

When you are finished uploading, be sure to save your work.


The Relationships tab keeps track of each character's relationships with other characters.

To add a relationship to a character, go to their Relationships tab, enter Edit Mode, and click "Add Relationship." The following window will appear.

Add Relationship window

You can choose a relationship from the dropdown menu, or choose "other" to enter your own. Then, use the search box to search the project for the other character.

If the characters' roles are reversed, click "Swap Roles." For example, the preset shown above ("Brother/Sister") lists Mary Sue as the brother by default. "Swap Roles" fixes this issue.


Tags make it easy to organize and group items in your project.

To tag a page, enter Edit Mode and type the tag into the "Add Tag" box, shown below. Make sure that you type it the same way each time (with the same capitalization and spelling).

Add Tag text box

Each tag has its own page that is created the first time you use it. These are filed under "Tags," underneath the divider in your project overview.

Tags folder

Tag pages list every item with that tag. You can also add notes and attachments, just like any other page.


Snippets are great for keeping a few lines of text to use later. The Snippets page is at the bottom of the project overview.

To add a new snippet, go to the page and click Edit. A text box will appear at the top to enter your text. Make sure you click "Add Snippet" when you're done.

Date and time editor

All your snippets will appear below, newest on top. Clicking any snippet will copy it to your clipboard so you can paste it elsewhere.

If you want to delete a snippet, you must be in Edit Mode. Then, click the trash can button in the upper right-hand corner of the snippet. Deleted snippets will be moved to the Trash tab, where you can either restore them or delete them permanently.

Character Chart

The Character Chart is one of the most powerful organizational tools in openworldcrafter. It is like a mini spreadsheet in your project that keeps track of statistics about each character. You can access the chart from the bottom of the project overview.

Character Sheets

To start adding information to your chart, you will need at least one character. Go to their Character Sheet tab and enter Edit Mode. Click the Add Property button, which will bring up a window to enter a new property.

Add Property modal

In this window, add a name and a value for the new property. For example, if you want to record that Mary Sue's favorite color is green, you would type "Favorite Color" in "Name" and "green" in "value." Remember that every time you use a property name, it must be spelled and capitalized the same way.

Click "Add" to finish adding the new property. It should now show up in the character sheet.

The Character Chart

Character chart

Each character has a Character Sheet tab that shows all their properties. However, there is also a Character Chart page near the bottom of your project overview that collects all your character charts into one place. Characters are listed as rows sorted in alphabetical order, and properties are listed as columns sorted by frequency of use.

You can edit any property in the chart, just like in a spreadsheet, in Edit Mode.

Color Coding

To color code a value, enter Edit Mode and hover over a cell with the value you would like to color. Choose a color from the dropdown menu that appears at the right of the cell. Now that value will be that color anywhere it occurs for that property. For example, if you had a "Has Magical Powers?" property, you could color-code "Yes" as green and "No" as red.

Color-coding dropdown