User Guide

Welcome! This guide takes you from installing Lexicon to running a well-organized, interlinked knowledge dictionary.

What is Lexicon?

Lexicon is a free, open-source application for structured learning and technical note-taking. Instead of a folder full of loose notes, you build a personal dictionary of items, organized into groups, enriched with metadata, and connected by typed links that form a concept graph.

Data is stored locally in a SQLite file, with optional attachments in an adjacent directory β€” no account, no cloud, no telemetry. You own your knowledge.

There are three clients over one dictionary: the Qt desktop application, which opens the database file directly, and a web client and a native Android app, which talk to LexiconServer next to that same file. What you write in one shows up in the others β€” including reviews, cards, alarms, the Inbox and the shared Board. Desktop and web additionally provide Mass Insert for creating a batch in one recoverable worksheet.

Lexicon main window with filters, item table, and rendered content
The main window: everything you need on one screen.

Core concepts

Five ideas are enough to understand the whole application:

ConceptWhat it isExample
GroupA top-level bucket that groups related items.C++, Databases, Networking
ItemA single concept with a title, Markdown content, and metadata.Move semantics, B-tree index
Tag / FlagLabels for classification (tags) and workflow markers (flags).Tags: cpp20, templates Β· Flags: review, needs-example
AliasAn alternate name or synonym that also matches in search.RAII for Resource Acquisition Is Initialization
LinkA typed relationship between two items (with automatic backlinks).std::vector β€” Is A β†’ container

Review brings due items back on a schedule, while cards let you quiz yourself on specific questions. Alarms ring in every client, the Inbox catches an idea before it is gone, and named shared Boards keep living Markdown overviews close at hand.

Quick start checklist

  1. Install and launch Lexicon. The database file is created automatically on first start.
  2. Organize your groups via Manage β†’ Groups.... A Default group is ready when you start.
  3. Add a few items with the Add button and fill in their titles.
  4. Use Mass Insert for a batch β€” choose one Group, an optional Type and fill several rows safely.
  5. Write content in Markdown in the Content tab and watch the live preview.
  6. Connect related items with typed links to grow your concept graph.
  7. Review what you wrote β€” the items due now, one card at a time.
  8. Quiz yourself with cards β€” questions about an item or its linked neighborhood.
  9. Set up a backup habit β€” copy the database and its adjacent blobs directory, or let the server back it up for you.

Guide chapters

Study Plan schedules books, courses and practice by weekday and shows today’s target.

πŸ“¦ Installation

Requirements, building on Debian/Ubuntu, Windows, and macOS, and what happens on first launch.

πŸš€ Getting started

Create groups, explore the main window, and add your first items the recommended way.

✍️ Editing items

The item editor in depth: General fields, Markdown content, Type values and metadata.

🧾 Mass Insert

Create many items in a desktop or web worksheet with optional Type values and a resumable local draft.

πŸ”— Links & relationships

Build a concept graph with typed links and backlinks β€” Is A, Part Of, Depends On, and more.

πŸ”Ž Search & navigation

Search, filters, sorting, pagination, global overviews, and switching between light and dark mode.

πŸŽ“ Review

Spaced repetition over your own items: what is due, the answer on request, and four ratings.

🧩 Cards & quiz

Write questions and answers for an item, then quiz yourself on it or its linked neighborhood.

⏰ Alarms

Reminders that ring on the desktop, in the browser and on the phone β€” until you dismiss them.

πŸ“₯ Inbox

Catch an idea in one step, even without a connection, and file it properly later.

πŸ“‹ Boards

Create, name, read and edit shared Markdown dashboards from the desktop, browser or Android app.

πŸ–§ Server, web & Android

Run LexiconServer and use the same dictionary from a browser and from your phone.

πŸ›Ÿ Backup & troubleshooting

Where your data lives, how to back it up, deletion safety rules, and fixes for common problems.