๐Ÿง  Alin Li ยท Knowledge Management

Logseq: Your Second Brain,
Open Source

Every note you take is connected. Every thought has context. Every idea links to another. Logseq isn't a notes app โ€” it's a thinking tool that grows with you. Privacy-first, local-first, free forever.

100%
Open source (AGPL)
Local
Files stay on YOUR device
30K+
GitHub stars
$0
Forever free
What is Logseq? ๐Ÿค”Power Points โšก
๐Ÿค” WHAT IS LOGSEQ?

Not a Notes App โ€” A Thinking Machine

๐Ÿง  Logseq = Outliner + Knowledge Graph + Daily Journal

Most note-taking apps treat your notes like files in folders โ€” you create a note, put it in a folder, and hope you remember where you put it. Over time, your notes become a graveyard of forgotten information.

Logseq is fundamentally different. It's built on three revolutionary ideas:

1. Everything is a block โ€” every bullet point is an independent unit that can be referenced, linked, embedded, and reused across your entire knowledge base. A single idea lives in one place but appears everywhere it's relevant.

2. Pages link to pages โ€” by typing [[Page Name]], you create a bidirectional link. If Page A links to Page B, then Page B automatically knows Page A referenced it. Your knowledge forms a web, not a tree.

3. Daily journal by default โ€” every day, Logseq opens a fresh journal page. You capture thoughts, meeting notes, tasks, and ideas throughout the day. Links and tags connect today's notes to everything you've ever written.

๐Ÿข Who Created Logseq?

Created in 2020 by Tienson Qin, a Chinese-born developer living in New Zealand. Tienson was frustrated with Roam Research (a commercial outliner-style tool that cost $15/month and stored your data on their servers). He believed that a knowledge tool this important should be open source, local-first, and free.

Logseq quickly gained a passionate community. It's funded through Logseq Sync (optional paid cloud sync, $5/month) and sponsorships โ€” while the core app remains 100% free and open source under AGPL-3.0.

๐Ÿ“ THE OUTLINER

See How It Works โ€” Live Example

โ€ข Today I learned about [[Open Source]] licensing
โ€ข [[GPL]] requires sharing modifications #important
โ€ข This is why [[Linux]] stays free โ€” everyone must share changes
โ€ข source:: [[Alin Li Course]] Chapter 13
โ€ข [[MIT License]] is the most permissive โ€” do anything you want
โ€ข Used by [[React]], [[VS Code]], [[Next.js]]
โ€ข TODO Research [[Creative Commons]] for my project #todo
โ€ข Meeting with [[Ahmed]] about the school website
โ€ข He wants to use [[WordPress]] โ€” I suggested [[Hugo]] instead
โ€ข DONE Send him the [[Hugo]] tutorial link #done
๐Ÿง  Notice What's Happening!

Every [[Page Reference]] creates a bidirectional link. When you open the page for "GPL", you'll see EVERY note you've ever written that mentions GPL โ€” automatically gathered from across your entire knowledge base. You never have to "file" anything. Just write, link, and Logseq does the organizing.

โšก 10 POWER POINTS

What Makes Logseq Different From Everything Else

01

๐Ÿ”— Bidirectional Links

Link any page to any page with [[double brackets]]. Both pages know about each other. Your notes form a web of connections, not isolated files. When you open any page, you see EVERY reference from across your entire knowledge base โ€” without manually organizing anything.

02

๐Ÿงฑ Block-Level Granularity

Every bullet point is an independent block with its own unique ID. You can reference a SINGLE bullet from anywhere: ((block-id)). Edit it in one place, it updates everywhere. One idea, one source of truth, infinite appearances. No other notes app does this as naturally.

03

๐Ÿ“… Daily Journal

Every day starts with a blank page named today's date. Just start writing. No deciding "where should this go?" โ€” write now, organize later through links and tags. Over weeks and months, your journal becomes a searchable timeline of everything you've thought, learned, and done.

04

๐ŸŒ Knowledge Graph

Logseq visualizes ALL your notes as an interactive graph โ€” nodes are pages, lines are links. You can SEE how your knowledge connects. Clusters of related ideas emerge visually. It's like looking at your brain from the outside. Zoom, filter, click to navigate โ€” your entire knowledge base in one view.

05

๐Ÿ’พ Local-First, Privacy-First

Your notes are stored as plain Markdown/Org-mode files on YOUR device. No cloud required. No account required. No internet required. Logseq reads files from a folder โ€” that's it. You can open the same files in any text editor. Your data is NEVER locked inside a proprietary database. Even if Logseq disappears tomorrow, your files remain perfectly readable.

06

๐Ÿ” Queries โ€” Your Personal Database

Logseq has a built-in query engine. Ask your notes questions: "Show me all TODOs tagged #school due this week" or "Find all blocks mentioning [[Python]] created in the last 30 days." Advanced queries use Datalog (a logic programming language). Your notes become a queryable database โ€” not a passive archive.

07

๐Ÿ“‹ Properties โ€” Structured Data

Add structured data to any block with properties: type:: book, author:: Martin Dougiamas, rating:: 5, date:: 2024-03-15. Then query them: "Show all books rated 5 stars." This turns Logseq into a personal database โ€” track books, projects, contacts, recipes, anything with structured metadata.

08

๐Ÿงฉ Plugins & Themes

200+ community plugins extend Logseq: Kanban boards, Pomodoro timers, mind maps, spaced repetition flashcards, AI integration, Git auto-commit, table views, calendar views, and more. Plus dozens of beautiful themes. The plugin system is open and anyone can build extensions.

09

โœ๏ธ Whiteboards

Logseq includes a built-in whiteboard โ€” an infinite canvas where you can draw, place blocks from your notes, connect ideas visually, add images, and create spatial layouts. Think Miro or FigJam but integrated with your entire knowledge base. Draw a diagram and link it to your notes.

10

๐Ÿ”“ 100% Open Source (AGPL-3.0)

Full source code on GitHub. Audit every line. Fork it. Modify it. Self-host it. No vendor lock-in. No "free tier that gets worse." No sudden price increases. No "we're shutting down, export your data in 30 days." Open source means Logseq belongs to the community โ€” forever.

โš”๏ธ COMPARISON

Logseq vs Notion vs Obsidian vs OneNote vs Roam

Honest comparison โ€” every tool has strengths.

Feature๐ŸŸข Logseqโฌ› Obsidian๐Ÿ”ต Notion๐ŸŸฃ OneNote๐Ÿ”ด Roam Research
Price$0 (forever)$0 (personal)Free tier (limited)$0 (with MS account)$15/month
Open Sourceโœ… AGPL-3.0โŒ ProprietaryโŒ ProprietaryโŒ ProprietaryโŒ Proprietary
Data Storageโœ… Local files (Markdown)โœ… Local files (Markdown)โŒ Cloud only (their servers)โŒ Cloud (OneDrive)โŒ Cloud only
Outlinerโœ… Core designโš ๏ธ Plugin onlyโš ๏ธ Toggle blocksโŒ Free-formโœ… Core design
Bidirectional Linksโœ… Nativeโœ… Nativeโš ๏ธ BasicโŒ Noโœ… Native
Block Referencesโœ… Nativeโš ๏ธ PluginโŒ NoโŒ Noโœ… Native
Knowledge Graphโœ… Built-inโœ… Built-inโŒ NoโŒ Noโœ… Built-in
Daily Journalโœ… Default viewโš ๏ธ PluginโŒ ManualโŒ Noโœ… Default
Queriesโœ… Powerful (Datalog)โš ๏ธ Dataview pluginโš ๏ธ Database filtersโŒ Noโœ… Roam queries
Whiteboardโœ… Built-inโœ… CanvasโŒ Noโœ… Free-formโŒ No
Pluginsโœ… 200+ openโœ… 1000+ (marketplace)โš ๏ธ IntegrationsโŒ Noneโš ๏ธ Limited
Mobile Appโœ… iOS + Androidโœ… iOS + Androidโœ… Excellentโœ… Goodโš ๏ธ Basic
CollaborationโŒ Single userโŒ Single userโœ… Excellent (real-time)โœ… Goodโš ๏ธ Limited
Offline Accessโœ… 100% (local files)โœ… 100%โŒ Limitedโš ๏ธ PartialโŒ Limited
File FormatMarkdown / Org-modeMarkdownProprietary DBProprietaryProprietary JSON
โœ… Choose Logseq When
  • โœ… You want open source (the ONLY fully open-source option)
  • โœ… You think in outlines (bullets, indentation, hierarchy)
  • โœ… Privacy is non-negotiable (local files, no cloud required)
  • โœ… You want a daily journal as your default entry point
  • โœ… You need block-level references (granular linking)
  • โœ… You want your data in plain Markdown (future-proof)
โš ๏ธ Consider Alternatives When
  • ๐Ÿ“ You need real-time team collaboration โ†’ Notion
  • ๐Ÿ“„ You prefer long-form writing over outlines โ†’ Obsidian
  • ๐Ÿ–Š๏ธ You want free-form handwriting โ†’ OneNote
  • ๐Ÿข You need project management for teams โ†’ Notion
  • ๐Ÿ”Œ You want the largest plugin ecosystem โ†’ Obsidian
๐Ÿš€ GET STARTED

Install & Start Using Logseq

๐Ÿ’ป Step 1: Download & Install (2 Minutes)

Go to logseq.com โ†’ Download for your platform (Linux, Windows, macOS). Or install via package managers:

Install Logseq
# Linux (Flatpak โ€” recommended) $ flatpak install flathub com.logseq.Logseq # Linux (AppImage โ€” portable, no install) # Download .AppImage from logseq.com โ†’ chmod +x โ†’ run! # macOS (Homebrew) $ brew install --cask logseq # Or: download from logseq.com for any platform # Mobile: iOS App Store / Google Play Store

๐Ÿ“ Step 2: Choose a Folder for Your Notes

When you first open Logseq, it asks for a graph directory โ€” this is just a folder on your computer where all your notes will be stored as Markdown files. Choose any folder. That's it โ€” no account, no signup, no cloud.

๐Ÿ’ก Sync Tip

Want to sync between devices? Point Logseq at a folder inside Syncthing (open source), Nextcloud, or Git. Or use Logseq's optional paid sync ($5/month). Your notes are just files โ€” any file sync works.

โœ๏ธ Step 3: Start Writing โ€” The Core Workflow

Logseq opens to today's journal page. Start typing. Use these essential patterns:

โ€ข Just type anything โ€” every bullet is a block
โ€ข Link to topics with [[double brackets]]
โ€ข Add tags with #hashtags
โ€ข Create tasks: TODO Buy groceries
โ€ข Add properties: type:: meeting
โ€ข Reference a specific block: ((block-id))
โ€ข Indent with Tab, outdent with Shift+Tab
โ€ข Slash command: type / for templates, dates, embeds
๐Ÿ“‹ WORKFLOWS

Real Workflows: How Students & Professionals Use Logseq

๐ŸŽ“ Student: Exam Preparation

Write lecture notes in your daily journal with [[Course Name]] links. Before exams, open the course page โ€” ALL your notes from every lecture are gathered automatically. Use flashcard plugin for spaced repetition. Query: "Show all blocks tagged #exam-topic from [[Biology 101]]". Create a whiteboard connecting key concepts visually.

๐Ÿ“– Reader: Book Notes & Knowledge Building

Create a page for each book: [[Atomic Habits]]. Add properties: author:: James Clear, rating:: 5, status:: finished. Write key takeaways as blocks. Link concepts to other books: "This connects to [[Deep Work]] โ€” both emphasize environment design." Over time, you build a personal library of interconnected ideas.

๐Ÿ’ป Developer: Technical Documentation

Document every technical decision: [[PostgreSQL]] vs [[MySQL]] with pros/cons blocks. Link to project pages: [[Project Alpha]]. When debugging, search your graph for similar issues. Tag solutions: #solved #linux #networking. Over months, your Logseq becomes a personal Stack Overflow.

๐Ÿ“‹ Project Manager: Meeting Notes & Tasks

Daily journal captures every meeting. Link people: [[Ahmed]], [[Sara]]. Tag tasks: TODO Follow up with [[Ahmed]] on budget. Query: "Show all open TODOs assigned to me this week." Open any person's page to see every meeting, decision, and task involving them โ€” automatic CRM from your notes.

๐Ÿ•Œ Islamic Studies: Connected Learning

Create pages for Surahs, Hadiths, scholars, and concepts. Link them: "In [[Surah Al-Baqarah]], verse 282 discusses financial contracts โ€” connects to [[Islamic Finance]] and [[Amanah]]." Tag by topic: #fiqh #aqeedah #tafseer. Over years, build a personal encyclopedia of interconnected Islamic knowledge that grows with every lesson and lecture.

๐Ÿงฉ ESSENTIAL PLUGINS

10 Must-Have Plugins

๐Ÿ“‹

Kanban Board

Turn any page into a drag-and-drop Kanban board

๐Ÿง 

Flashcards (SRS)

Spaced repetition from your blocks โ€” study smarter

๐Ÿ“Š

Table View

Display query results as sortable, filterable tables

๐Ÿ“…

Full Calendar

See journal entries and deadlines in calendar view

๐Ÿ”„

Git Auto-Commit

Automatically backup notes to Git with every change

๐Ÿค–

GPT / AI Integration

Summarize, expand, translate blocks using AI โ€” locally or cloud

๐Ÿ“ˆ

Charts

Create charts and visualizations from your data blocks

๐ŸŽจ

Tabs

Open multiple pages in tabs like a browser

โฑ๏ธ

Pomodoro Timer

Focus timer integrated into your task management

๐Ÿ—บ๏ธ

Mind Map

Visualize any page as a mind map automatically

๐Ÿ”Œ Install Plugins

Open Logseq โ†’ Settings (gear icon) โ†’ Plugins โ†’ Marketplace โ†’ Search and install with one click. All plugins are community-made, open source, and free.

๐Ÿ’ก PRO TIPS

7 Tips for Logseq Mastery

1. Don't Organize โ€” Just Write and Link

The biggest mistake new users make: trying to create a perfect folder structure before writing anything. In Logseq, organization happens THROUGH links. Just write in your journal, use [[links]] generously, and structure will emerge organically. Trust the graph.

2. Use Templates for Repeating Structures

Create templates for meetings, book notes, weekly reviews, project kickoffs. Type /template to insert one. Example meeting template: Date, Attendees (linked!), Agenda, Decisions, Action Items (TODOs). Consistency without effort.

3. Review Linked References Daily

At the bottom of every page, Logseq shows "Linked References" โ€” every block from your entire graph that mentions this page. This is where MAGIC happens: ideas you forgot about resurface. Spend 5 minutes reviewing linked references on important pages.

4. Use Properties for Structured Data

Properties turn Logseq into a personal database. Track books (status:: reading), projects (deadline:: 2025-06-01), people (role:: mentor). Then query them: {{query (property status "reading")}}.

5. Sync with Git for Free Backup

Point your Logseq folder at a Git repo. Use the "Git Auto-Commit" plugin to save every change. Push to GitHub/Gitea for free cloud backup + version history. Every edit is tracked โ€” you can never lose work.

6. Do Weekly Reviews

Every Sunday, create a "Weekly Review" template: What did I learn? What went well? What's next? Link to the week's key pages. Over time, weekly reviews become an incredible journal of personal growth โ€” fully linked to your knowledge base.

7. Explore the Graph View Regularly

Open the graph view (shortcut: Ctrl+Shift+G) and zoom around. You'll discover connections you didn't know existed. Orphan pages (no links) are ideas that need connecting. Dense clusters are your strongest knowledge areas. The graph is a mirror of your mind.

๐Ÿง ๐Ÿ”—โœจ

Your Thoughts. Connected. Searchable. Yours.

Logseq is not just a place to store notes โ€” it's a tool that makes you think better. Every link you create strengthens a connection. Every journal entry adds to your timeline. Over months and years, your Logseq graph becomes the most valuable thing on your computer: a map of everything you know, think, and discover.

๐Ÿ”—
Link everything
๐Ÿ“…
Journal daily
๐Ÿ”
Query your brain
๐Ÿ”“
Own your data

ยซุงู‚ู’ุฑูŽุฃู’ ุจูุงุณู’ู…ู ุฑูŽุจูู‘ูƒูŽ ุงู„ูŽู‘ุฐููŠ ุฎูŽู„ูŽู‚ูŽ โ€ข ุนูŽู„ูŽู‘ู…ูŽ ุงู„ู’ุฅูู†ุณูŽุงู†ูŽ ู…ูŽุง ู„ูŽู…ู’ ูŠูŽุนู’ู„ูŽู…ู’ยป

"Read! ...He taught man what he did not know." โ€” Quran 96:1,5

Logseq helps you capture, connect, and REMEMBER everything you learn. Every link is a bridge between ideas. Every page is a preserved lesson. This is technology in service of knowledge โ€” exactly as it should be. โœจ