Skip to Content
Welcome to Reflecto Docs - Your guide to mindful journaling
Writing & EditorRich Text Editor

Rich Text Editor

Reflecto’s editor is built on TipTap , providing a distraction-free writing experience with markdown shortcuts, inline formatting, smart extraction of tags and people, and automatic saving.

The editor converts markdown as you type, so you never need to switch between editing and preview modes.


Formatting Toolbar

When you select text, a floating toolbar appears above your selection:

ButtonAction
BBold
IItalic
UUnderline
H1, H2, H3Heading levels
Bullet listUnordered list
LinkInsert or edit a hyperlink

The toolbar positions itself above your selection so it never obscures your text.


Markdown Shortcuts

Type these patterns followed by a space or enter to convert them instantly:

ShortcutResult
# Heading 1
## Heading 2
### Heading 3
**text**Bold
*text*Italic
- or * Bullet list
> Blockquote
---Horizontal rule
[text](url)Hyperlink

Keyboard Shortcuts

ShortcutAction
Ctrl/Cmd + BBold
Ctrl/Cmd + IItalic
Ctrl/Cmd + UUnderline
Ctrl/Cmd + KInsert or edit link
Ctrl/Cmd + ZUndo
Ctrl/Cmd + Shift + ZRedo
Ctrl/Cmd + SManual save

@Mentions

Type @ followed by a name to mention someone in your entry.

Type @ in the editor

A suggestion dropdown appears showing previously mentioned people.

Select or create

Use arrow keys to navigate, press Enter to select, or keep typing to create a new person.

Auto-extraction on save

When you save, mentioned people are extracted and linked to the entry. They appear on the People page.

Had lunch with @Alice and discussed the plan with @Bob.

The dropdown shows matching people with their mention counts and a “Create new” option at the bottom.


#Tags

Type # followed by a keyword to tag your entry.

Type # in the editor

A suggestion dropdown appears showing existing tags.

Select or create

Choose an existing tag or keep typing to create a new one.

Auto-extraction on save

Tags are extracted when you save and link the entry to the Tags page.

Productive session on #project-alpha with focus on #design.

Tags are case-insensitive and support letters, numbers, and hyphens.


Image Uploads

Add images to any entry through drag-and-drop, clipboard paste, or the toolbar button.

Drag an image file from your file explorer directly into the editor. It uploads automatically and appears inline.

Supported formats: JPEG, PNG, GIF, WebP

Size limit: 10MB per image

Images are resizable after upload — drag the corners to adjust while maintaining aspect ratio.

Images are stored on a CDN with secure, private links. Only you can access your uploaded images.


Auto-Save

Your entries save automatically after 3 seconds of inactivity. The cloud icon in the header shows the current status:

  • Saving… — upload in progress
  • Saved — successfully synced
  • Error — save failed, retries automatically

Press Ctrl/Cmd + S to trigger an immediate save without waiting for the debounce timer.

If you try to close the page with unsaved changes, a warning dialog will ask you to confirm before leaving.

When you save, the system extracts tags and people from your content, updates metadata, and syncs everything to the cloud.


Editor Modes

Bulleted Mode

The default mode for journal entries. Every new line becomes a bullet point, and a count (e.g., #15) appears in the header showing total bullets.

* Woke up feeling energized * Morning coffee with @Alice * Completed the #project-alpha milestone * Feeling #grateful for team support

Bulleted mode is ideal for daily logs, gratitude lists, and quick captures.

Simple Mode

A standard rich text editor without automatic bullet formatting. Better for longer-form narrative writing.

Toggle between modes using the bullet icon in the Write page header, or set your default in Settings.


Metadata Panel

Above the editor, metadata fields change based on entry type:

  • Mood selector — 1 to 5 scale (journal entries)
  • Category picker — Thoughts, Gratitude, Reflections, and more (journal entries)
  • Star toggle — mark any entry as important
  • Importance — High, Medium, Low (highlights)
  • Status — Seed, Draft, Refined, Implemented (ideas)

Metadata is searchable and appears in entry lists across the app.


Linked Context

When editing an existing entry, a sidebar section shows related entries:

  • Same date — other entries written on the same day
  • Shared tags — entries using the same tags
  • Shared people — entries mentioning the same people

This helps you recall context, spot patterns, and connect related thoughts without leaving the editor.


Tips

  • Use tags consistently — reuse tags like #work and #health to build connections over time
  • Mention people often — @mentions create a relationship map you can explore later
  • Write daily — even a few bullets maintain your streak and build the habit
  • Check linked context — when editing old entries, the sidebar reveals connections you may have forgotten
  • Try different entry types — journals, ideas, highlights, and dreams each serve different purposes
Last updated on