Create a new note

  • Click the βž• New note button and enter a name.
  • The item will appear in the list. Click to load the name and content into the editor above.
  • Edit the content and click Save now.

Slash Command - Quick command help

  1. Type / in the editor β†’ a menu with commands will appear
  2. Filtering The menu is filtered by the next text (e.g. /da will display /date)
  3. Navigation: ↓↑ = Move up/down in the menu Enter/Tab = Select the current command Escape = Close the menu
  4. Click on the command Insert at the cursor position
  5. Automatically close when clicking outside

Available slash commands:

/date - Insert today's date (πŸ“…)
/time - Insert time (πŸ•)
/code - Inline code (πŸ’»)
/codeblock - Code block (πŸ“)
/link - Insert link (πŸ”—)
/image - Insert image (πŸ–Ό)
/table - Insert table (β–¦)
/quote - Quote (❝)
/hr - Horizontal line (β€”)
/task - Task/checkbox (☐)
/list - Bulleted list (β€’)
/h1 - H1 Heading
/h2 - H2 Heading
/h3 - H3 Heading

Tags

Tags are words or phrases that describe the content of a note. In the Doxa application, they allow you to filter notes by tag.

Click in the tags field and enter the name of the tag (it will be saved with the note).

You can then search for a note using the tag in the magnifying glass field Filter notes by tag...

Editing and deleting

Inline: click on the note, edit the content and press Save now.

Modal: click on the ✎ icon next to the item for advanced editing in the modal window.

Deleting: the πŸ—‘ icon next to the item β€” after confirmation, the note will be deleted.

Moving the order of notes

Use the ↑ / ↓ arrows on the items.

Or drag and drop items to the desired location β€” the insertion indicator will appear when dragging.

Switching the appearance

You will find a button for switching the appearance in the top menu. The application supports three modes:

  • Light β€” icon: β˜€οΈ
  • Dark β€” icon: πŸŒ™
  • Respect system β€” icon: πŸŒ“ β€” the application will follow the system choice (prefers-color-scheme) and will automatically switch if the system theme changes.

By clicking the button in the menu you can cycle between modes (Light β†’ Dark β†’ System). The selected option is saved in localStorage under the doxa_theme key and persists between pages and refreshes. If you want to reset the option, open the browser console and run: localStorage.removeItem('doxa_theme') or clear the storage in the developer tools.

Autosave

The application now automatically saves changes to notes locally while writing (autosave). In a regular browser, changes are saved to localStorage (doxa_notes_v1 key) without the need for manual saving β€” the data is saved after a short delay. If you run the application in Electron/Node mode, changes are written directly to the local file.

Save the JSON file manually as you go!!

Manual saving

Next to the editor you will find a Save Now button. Even though autosave saves continuously, the button is useful in the following cases:

  • Immediate save β€” will persist without waiting for autosave (useful before closing the application or if you want a quick confirmation that the changes are written).
  • Visual confirmation β€” after saving, the status "Saved" will be displayed, giving the user immediate feedback.
  • No download β€” the Save note button does not download the file; if you want to download JSON, use the Export JSON button.

To transfer data between devices, use the Export JSON button (which will download the doxa.json file), or run saveNotesToFile(true) from the console.

Import / Export

To import, click Import JSON and select a file. Supported formats:

  • Object with notes field: { "notes": [ ... ] }
  • Direct field: [ { ... }, { ... } ]

Export is now available via the Export JSON button (next to the Save button). The application also performs autosave locally β€” you won't lose anything if you forget to save manually. To download JSON via a script, you can also run saveNotesToFile(true) in the console.

  • Since version 26.07.04 Import/Export: the folder field is saved in JSON, backward compatible with older data (empty field).

Export to Markdown

You can export an individual note to Markdown.

The export is in the format nΓ‘zevPoznamky.md

Search (Filtration)

  • Filtering: the "πŸ“ All folders" drop-down limits the list to only the selected folder.
  • Search: the field searches in the name, content, tags and folder name (fulltext).

Folders

  • Folders: fill in the "Folder" field for the note or write a line in the content in the form folder: Name (the field has native suggestions β€” a list of existing folders).
  • Assignments can also be edited manually in the Folder field; changes are saved automatically.

Security and backups

The default mode is local-first: data remains in your browser (localStorage) or a local file, the application does not send it itself.

Common problems

  • When opening via file://, fetching static JSON may fail β€” use a local server or Electron.
  • Transferring data between devices? Download JSON and import it on the second device.

Markdown

Editor uses Markdown

The editor works with Markdown syntax. All edits are saved as Markdown (plain text) β€” the preview shows the rendered HTML. Below are basic examples (paste them directly into the editor or use the buttons in the toolbar):

Bold: **bold text**
Italic: *italic*
Strikethrough: ~~strikethrough~~
Inline code: `code`
Code block:

console.log('hello')

Headings:
# Heading H1
## Heading H2
### Heading H3
List (bullets):
- item 1
- item 2
Numbered list:
1. first
2. second
Quote:
> This is a quote
Table:
| Column 1 | Column 2 |
| --- | --- |
| cell 1 | cell 2 |
| cell 3 | cell 4 |
Image (reference URL):
![alt text](https://example.com/image.png)
Link:
[text](https://example.com)
Task list:
- [ ] not completed
- [x] done

Important tips:

  • Click the toolbar buttons to insert the necessary Markdown tokens automatically.
  • Press Ctrl/Cmd+B for bold, Ctrl/Cmd+I for italic, and Ctrl/Cmd+` for inline code.
  • The Preview button toggles Markdown rendering; use it to verify the result.
  • The Table button (β–¦) inserts a table template and prompts you for a number of characters during insertion columns and rows.
  • Insert images as URLs β€” the app does not sync or upload images.
  • Markdown is portable: notes remain readable even without the app (export/import).