From 12b10fcbea216b31a5df864d2937e84a0b7d8b4b Mon Sep 17 00:00:00 2001 From: tehtbl <3999809+tehtbl@users.noreply.github.com> Date: Wed, 15 Apr 2026 19:13:12 +0200 Subject: [PATCH 01/12] docs: improve contributing guide, add issue templates and link checker - Rewrite contributing.md with entry format guide, icon reference table, checklist for new entries, and category descriptions - Update PR template with description section and submission checklist - Add GitHub issue templates for tool suggestions and issue reports - Add weekly dead link checker workflow using lychee-action --- .github/ISSUE_TEMPLATE/report-issue.yml | 32 ++++++++++++ .github/ISSUE_TEMPLATE/suggest-tool.yml | 49 ++++++++++++++++++ .github/pull_request_template.md | 15 +++++- .github/workflows/check-links.yml | 28 +++++++++++ contributing.md | 66 +++++++++++++++++++++++-- 5 files changed, 183 insertions(+), 7 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/report-issue.yml create mode 100644 .github/ISSUE_TEMPLATE/suggest-tool.yml create mode 100644 .github/workflows/check-links.yml diff --git a/.github/ISSUE_TEMPLATE/report-issue.yml b/.github/ISSUE_TEMPLATE/report-issue.yml new file mode 100644 index 0000000..61a3683 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/report-issue.yml @@ -0,0 +1,32 @@ +name: "Report an issue" +description: "Report a broken link, outdated entry, or incorrect information" +labels: ["bug"] +body: + - type: input + id: tool + attributes: + label: Tool name + placeholder: "Which tool has the issue?" + validations: + required: true + - type: dropdown + id: issue_type + attributes: + label: Issue type + options: + - "Broken link" + - "Outdated description" + - "Wrong category" + - "Project abandoned/archived" + - "License changed" + - "Duplicate entry" + - "Other" + validations: + required: true + - type: textarea + id: details + attributes: + label: Details + description: "What's wrong and what should it be?" + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/suggest-tool.yml b/.github/ISSUE_TEMPLATE/suggest-tool.yml new file mode 100644 index 0000000..9c1ca49 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/suggest-tool.yml @@ -0,0 +1,49 @@ +name: "Suggest a tool" +description: "Suggest a new note-taking tool to add to the list" +labels: ["suggestion"] +body: + - type: input + id: name + attributes: + label: Tool name + placeholder: "e.g., Obsidian" + validations: + required: true + - type: input + id: url + attributes: + label: URL + placeholder: "https://..." + validations: + required: true + - type: dropdown + id: category + attributes: + label: Category + options: + - "Open Source — Native GUI" + - "Open Source — CLI" + - "Open Source — TUI" + - "Open Source — Editor Plugin" + - "Open Source — Electron" + - "Open Source — Tauri" + - "Open Source — Web UI" + - "Proprietary" + validations: + required: true + - type: textarea + id: description + attributes: + label: Description + description: "Brief description (1-2 sentences)" + validations: + required: true + - type: checkboxes + id: checks + attributes: + label: Verification + options: + - label: "I verified this tool is not already on the list" + required: true + - label: "This tool is actively maintained (last commit within 12 months)" + required: true diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 87b2406..cb07c86 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,3 +1,14 @@ -**By submitting this pull request, I promise I have read the [contribution guidelines](https://github.com/tehtbl/awesome-note-taking/blob/master/contributing.md) twice and ensured my submission follows it. 🖖** +## What does this PR do? -⬆⬆⬆⬆⬆⬆⬆⬆⬆⬆ + + +## Checklist + +- [ ] I have read the [contribution guidelines](contributing.md) +- [ ] The entry follows the correct format: `- [icons] [Name](URL) - Description. \`LICENSE\` \`Tech\`` +- [ ] The tool is not already on the list +- [ ] The tool is actively maintained (last commit within 12 months) +- [ ] Icons are accurate (checked platform support, sync, encryption) +- [ ] The link works and points to the official source +- [ ] For open-source tools: license (SPDX) and tech stack are included +- [ ] Added to the correct category diff --git a/.github/workflows/check-links.yml b/.github/workflows/check-links.yml new file mode 100644 index 0000000..6ff5f50 --- /dev/null +++ b/.github/workflows/check-links.yml @@ -0,0 +1,28 @@ +name: Check Links + +on: + push: + branches: [master] + pull_request: + branches: [master] + schedule: + - cron: "0 8 * * 1" # Every Monday at 08:00 UTC + +jobs: + linkcheck: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Link Checker + uses: lycheeverse/lychee-action@v2 + with: + args: --verbose --no-progress README.md + fail: false + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + - name: Upload link check report + uses: actions/upload-artifact@v4 + if: always() + with: + name: link-report + path: ./lychee/out.md diff --git a/contributing.md b/contributing.md index 565ae38..09898ba 100644 --- a/contributing.md +++ b/contributing.md @@ -1,11 +1,67 @@ # Contribution Guidelines -Please note that this project is released with a [Contributor Code of Conduct](code-of-conduct.md). By participating in this project you agree to abide by its terms. +Please note that this project is released with a +[Contributor Code of Conduct](code-of-conduct.md). By participating in this +project you agree to abide by its terms. + +## Adding a new tool + +Please ensure your pull request adheres to the following guidelines: + +### Entry format + +``` +- [icons] [Tool Name](URL) - Brief description ending with a period. `LICENSE` `Tech/Language` +``` + +**Examples:** + +``` +- 📖🔁 [Joplin](https://joplinapp.org/) - Open source note-taking with sync and E2EE support. `AGPL-3.0` `Electron/TypeScript` +- 📕🤖🔁 [Taskade](https://www.taskade.com) - Collaborative note-taking and task management with AI. (Proprietary) +``` + +### Icon reference + +| Icon | Add when... | +|:----:|:------------| +| 📖 | Notes are stored in plain text (Markdown, org-mode, wiki, etc.) | +| 📕 | Notes are stored in a database or proprietary format | +| 🤖 | The tool has an Android app | +| 🍎 | The tool has an iOS app | +| 👍 | You have personally used it for years and recommend it | +| 🔁 | The tool provides built-in multi-device sync | +| 🔒 | The tool supports end-to-end encryption | +| ⚠️ | Project is archived or no longer actively maintained | + +### Checklist for new entries + +- [ ] The tool is primarily for note-taking or knowledge management +- [ ] The description is concise (1-2 sentences) and ends with a period +- [ ] The link goes to the official website or GitHub repo +- [ ] Icons are accurate (check platform support, sync, encryption) +- [ ] For open-source tools: license (SPDX) and tech stack are included +- [ ] The entry is added to the correct category +- [ ] The entry is not a duplicate of an existing entry +- [ ] The tool is actively maintained (last commit within 12 months) + +### Categories + +Pick the **single most appropriate** category: + +- **Native GUI** — Desktop apps with native UI (Qt, GTK, SwiftUI, Flutter, etc.) +- **CLI** — Command-line tools +- **TUI** — Terminal user interfaces +- **Editor Plugin** — Plugins for text editors (VS Code, Emacs, Vim, etc.) +- **Electron** — Desktop apps built with Electron +- **Tauri** — Desktop apps built with Tauri +- **Web UI** — Web-based or self-hosted applications +- **Proprietary** — Closed-source commercial tools ## Updating your PR -A lot of times, making a PR adhere to the standards above can be difficult. If -the maintainers notice anything that we'd like changed, we'll ask you to edit -your PR before we merge it. There's no need to open a new PR, just edit the -existing one. If you're not sure how to do that, [here is a guide](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md) +If the maintainers notice anything that we'd like changed, we'll ask you to +edit your PR before we merge it. There's no need to open a new PR, just edit +the existing one. If you're not sure how to do that, +[here is a guide](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md) on the different ways you can update your PR so that we can merge it. From e2f9f2331c1e3ff2d291ff383b15f7789cefb064 Mon Sep 17 00:00:00 2001 From: tehtbl <3999809+tehtbl@users.noreply.github.com> Date: Wed, 15 Apr 2026 19:13:16 +0200 Subject: [PATCH 02/12] docs: add evaluation framework and manual steps checklist - Add docs/evaluation/ with 30-parameter evaluation system - Include LLM evaluator prompt for batch project assessment - Include current project list (pipe-delimited) for evaluation input - Add TODO-manual-steps.md for GitHub repo metadata updates --- TODO-manual-steps.md | 45 +++++ docs/evaluation/README.md | 23 +++ docs/evaluation/evaluator-prompt.md | 281 ++++++++++++++++++++++++++++ docs/evaluation/parameters.md | 115 ++++++++++++ docs/evaluation/projects.txt | 102 ++++++++++ 5 files changed, 566 insertions(+) create mode 100644 TODO-manual-steps.md create mode 100644 docs/evaluation/README.md create mode 100644 docs/evaluation/evaluator-prompt.md create mode 100644 docs/evaluation/parameters.md create mode 100644 docs/evaluation/projects.txt diff --git a/TODO-manual-steps.md b/TODO-manual-steps.md new file mode 100644 index 0000000..ba67ee3 --- /dev/null +++ b/TODO-manual-steps.md @@ -0,0 +1,45 @@ +# Manual Follow-Up Steps + +These tasks cannot be done via git and require action on GitHub directly. + +## 1. Update repository description + +Navigate to: https://github.com/tehtbl/awesome-note-taking/settings + +**Current:** +> A curated list of awesome note-taking software. + +**Change to:** +> A curated list of 100+ awesome note-taking apps, PKM tools & knowledge management software — open source and proprietary. Updated regularly. + +## 2. Update repository topics + +Navigate to the repo homepage, click the gear icon next to "About". + +**Current topics:** `awesome`, `notes`, `awesome-list`, `note-taking`, `awesome-lists` + +**Add these topics** (GitHub allows up to 20): +- `productivity` +- `markdown` +- `pkm` +- `personal-knowledge-management` +- `knowledge-base` +- `second-brain` +- `zettelkasten` +- `self-hosted` +- `note-taking-app` + +## 3. Pin repository on GitHub profile + +Navigate to your GitHub profile (https://github.com/tehtbl), click "Customize your pins", +and add `awesome-note-taking` to your pinned repositories. + +## 4. Post-merge growth actions + +After the PR is merged: + +1. Submit to Hacker News as "Show HN: I curated 100+ note-taking tools with a comparison table" +2. Post in r/selfhosted, r/ObsidianMD, r/productivity, r/PKMS, r/linux +3. Open PRs to awesome-selfhosted and awesome-productivity linking to this list +4. Reach out to top projects (Joplin, Logseq, SiYuan, etc.) to add an awesome-note-taking badge +5. Verify the list is on sindresorhus/awesome master list diff --git a/docs/evaluation/README.md b/docs/evaluation/README.md new file mode 100644 index 0000000..7d2f207 --- /dev/null +++ b/docs/evaluation/README.md @@ -0,0 +1,23 @@ +# Project Evaluation Framework + +This directory contains tools to systematically evaluate all projects +in the awesome-note-taking list. + +## Files + +- `parameters.md` — The 30 evaluation parameters used to compare projects +- `evaluator-prompt.md` — Claude/LLM system prompt to run the evaluation +- `projects.txt` — Auto-generated list of all projects (pipe-delimited) + +## How to run an evaluation + +1. Copy the system prompt from `evaluator-prompt.md` +2. Paste `projects.txt` as the input data +3. Follow the instructions in the prompt for batched or single-pass processing +4. Save results to `results/` directory + +## When to re-evaluate + +- Before major refactors +- Quarterly (to catch abandoned projects) +- When adding a large batch of new tools diff --git a/docs/evaluation/evaluator-prompt.md b/docs/evaluation/evaluator-prompt.md new file mode 100644 index 0000000..34e3804 --- /dev/null +++ b/docs/evaluation/evaluator-prompt.md @@ -0,0 +1,281 @@ +# Claude Opus 4.6 — Awesome Note-Taking Project Evaluator + +## System Prompt + +You are an expert software analyst and open-source project evaluator. Your task is to systematically evaluate note-taking software projects against a standardized set of parameters and produce a comprehensive comparison table. + +## YOUR MISSION + +You will receive a list of note-taking projects (name, URL, category). For EACH project you must: +1. Visit the project URL and/or its GitHub repository +2. Research the project across all evaluation parameters +3. Fill in every parameter with accurate, current data +4. Flag any project that appears abandoned, archived, or dead +5. Output the results in the specified table format + +## INPUT FORMAT + +You will receive a project list file with this format: +``` +# comment lines start with # +ProjectName|URL|Category +``` + +The file is located at: `projects.txt` +(See the attached file or paste its contents into the conversation.) + +## EVALUATION PARAMETERS + +For each project, evaluate ALL of the following 30 parameters. If a parameter cannot be determined, use `?` (unknown). Never guess — mark as unknown rather than speculate. + +### Group 1: Project Health & Activity + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 1 | GitHub Stars | `stars` | Number (e.g., `35.2k`, `450`) or `N/A` if no GitHub repo | +| 2 | Last Commit Date | `last_commit` | `YYYY-MM` format, or `archived`, `abandoned`, `N/A` | +| 3 | Release Cadence | `release_cadence` | `active` (release within 3 months), `slow` (3-12 months), `stale` (>12 months), `none` (no releases ever), `archived` | +| 4 | Contributor Count | `contributors` | Number or `N/A` | +| 5 | Open Issues Count | `open_issues` | Number or `N/A` | + +### Group 2: Licensing & Cost + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 6 | License | `license` | SPDX identifier (e.g., `MIT`, `AGPL-3.0`, `GPL-3.0`, `Apache-2.0`, `MPL-2.0`) or `Proprietary` or `Source-available` | +| 7 | Pricing Model | `pricing` | `free`, `freemium`, `paid`, `open-core`, `donation-based` | +| 8 | Free Tier Limitations | `free_limits` | Brief text or `unlimited` or `N/A` | + +### Group 3: Platform Support + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 9 | Desktop Platforms | `desktop` | Comma-separated: `Windows`, `macOS`, `Linux` or `—` if none | +| 10 | Mobile Platforms | `mobile` | `Android`, `iOS`, `Android, iOS` or `—` if none | +| 11 | Web Access | `web` | `yes` (hosted service), `self-hosted` (user must deploy), `—` | +| 12 | Browser Extension | `browser_ext` | `Chrome`, `Firefox`, `Chrome, Firefox`, `yes` (generic), `—` | + +### Group 4: Data & Storage + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 13 | Storage Format | `storage` | `plain-text/markdown`, `plain-text/org`, `plain-text/wiki`, `plain-text/other`, `SQLite`, `custom-db`, `proprietary-cloud`, `JSON`, `mixed` | +| 14 | Local-First | `local_first` | `yes`, `optional`, `no` (cloud-required) | +| 15 | Self-Hostable | `self_host` | `yes`, `—` | +| 16 | Export Formats | `export` | Comma-separated: `Markdown`, `PDF`, `HTML`, `JSON`, `TXT`, `DOCX`, `ENEX`, `OPML`, `CSV` or `—` | +| 17 | Import Sources | `import` | Comma-separated known sources or `—` | + +### Group 5: Sync & Security + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 18 | Built-in Sync | `sync` | `yes-proprietary`, `yes-e2ee`, `yes-self-hosted`, `git`, `3rd-party`, `—` | +| 19 | End-to-End Encryption | `e2ee` | `yes`, `optional`, `—` | +| 20 | Real-time Collaboration | `collab` | `yes`, `—` | + +### Group 6: Core Features + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 21 | Editor Type | `editor` | `markdown`, `WYSIWYG`, `block-based`, `outliner`, `rich-text`, `handwriting`, `hybrid`, `plain-text`, `wiki` | +| 22 | Markdown Support | `markdown` | `native`, `supported`, `export-only`, `—` | +| 23 | Backlinks / Graph View | `backlinks` | `yes`, `backlinks-only`, `graph-only`, `—` | +| 24 | Organization Method | `organization` | Comma-separated: `tags`, `folders`, `notebooks`, `outliner`, `links/graph`, `spaces`, `databases` | +| 25 | Full-text Search | `search` | `yes`, `basic`, `—` | +| 26 | Plugin/Extension System | `plugins` | `yes-large` (100+ community plugins), `yes`, `limited`, `—` | +| 27 | API Available | `api` | `yes`, `limited`, `—` | +| 28 | AI Features | `ai` | `built-in`, `plugin`, `—` | +| 29 | Offline Mode | `offline` | `full`, `partial`, `—` | + +### Group 7: Technology + +| # | Parameter | Output Key | Accepted Values | +|---|-----------|------------|-----------------| +| 30 | Tech Stack | `tech` | e.g., `Electron/TypeScript`, `Tauri/Rust`, `Flutter/Dart`, `Native/C++`, `Web/React` | + +## PROCESSING RULES + +1. Process projects in order as they appear in the input file. +2. Batch output: Process ALL projects, then output the full result table at the end. +3. GitHub repos: If the URL is a GitHub repo, extract stars, commits, license, contributors, and issues directly. +4. Proprietary projects: Use `N/A` for GitHub-specific fields. +5. Dead projects: If a project is clearly abandoned, add a `ABANDONED` flag in the notes. +6. Duplicates: Flag as `DUPLICATE` and evaluate only once. +7. Sub-projects: Editor plugins should be evaluated as their own entries. +8. Accuracy over speed: Mark unknown as `?` rather than guessing. + +## OUTPUT FORMAT + +### Part 1: Full Evaluation Data (JSON) + +Output each project as a JSON object: + +```json +{ + "name": "ProjectName", + "url": "https://...", + "category": "Open Source > Electron", + "github_url": "https://github.com/...", + "flags": [], + "evaluation": { + "stars": "15.2k", + "last_commit": "2025-03", + "release_cadence": "active", + "contributors": "245", + "open_issues": "312", + "license": "AGPL-3.0", + "pricing": "free", + "free_limits": "unlimited", + "desktop": "Windows, macOS, Linux", + "mobile": "Android, iOS", + "web": "self-hosted", + "browser_ext": "Chrome, Firefox", + "storage": "plain-text/markdown", + "local_first": "yes", + "self_host": "yes", + "export": "Markdown, PDF, HTML, JSON", + "import": "Evernote, Notion, Markdown", + "sync": "yes-e2ee", + "e2ee": "yes", + "collab": "—", + "editor": "block-based", + "markdown": "native", + "backlinks": "yes", + "organization": "folders, tags, links/graph", + "search": "yes", + "plugins": "yes-large", + "api": "yes", + "ai": "plugin", + "offline": "full", + "tech": "Electron/TypeScript" + }, + "notes": "Any important observations, warnings, or context." +} +``` + +### Part 2: Condensed Comparison Table (Markdown) + +After the JSON data, output a condensed markdown comparison table: + +``` +| Tool | Stars | Act | License | Price | Desktop | Mobile | Web | Storage | Local | E2EE | Sync | Editor | BkLnk | Plugins | AI | +|------|-------|-----|---------|-------|---------|--------|-----|---------|-------|------|------|--------|-------|---------|-----| +``` + +Where condensed values are: +- **Act** = Activity: `green` (active <=3mo), `yellow` (slow 3-12mo), `red` (stale >12mo), `dead` (archived) +- **Desktop** = `W` Win, `M` Mac, `L` Linux combined (e.g., `WML`) +- **Mobile** = `A` Android, `i` iOS combined (e.g., `Ai`) or `—` +- **Web** = `yes`, `SH` (self-hosted), `—` +- **Storage** = `MD`, `DB`, `Org`, `Wiki`, `JSON`, `Mix`, `Prop` +- **Local** = `yes` (local-first), `opt` (optional), `cloud` +- **Editor** = `MD`, `WY`, `BL`, `OL`, `RT`, `HY`, `PT` + +### Part 3: Summary Statistics + +After the table, provide: +1. Total projects evaluated +2. Count by activity status (active/slow/stale/archived) +3. Count by pricing model +4. Count by license type (open-source vs proprietary) +5. Count with E2EE support +6. Count with plugin systems +7. Count with AI features +8. Count with mobile support +9. Top 10 by GitHub stars +10. List of abandoned/archived projects to reconsider + +### Part 4: Recommendations + +1. Projects to remove (abandoned, archived, dead) +2. Projects to flag (license changes, major concerns) +3. Entries to update (outdated descriptions, wrong categories) +4. Duplicates to merge +5. Missing projects (suggest 10-15 notable tools not on the list) + +## RESEARCH METHODOLOGY + +For each project, follow this investigation order: + +1. GitHub repository (if available): stars, forks, contributors, issues, license, last commit, tech stack +2. Official website: pricing, features, platforms, API, self-hosting, import/export +3. App stores (if applicable): Play Store / App Store presence +4. External sources (only if needed): AlternativeTo for verification + +## IMPORTANT CONSTRAINTS + +- Do NOT fabricate data. Every value must be sourced. +- Mark unknown values as `?` rather than guessing. +- Use the current date for calculating activity status. +- Some "open source" projects may have changed their license. Check current status. +- GitHub stars: approximate to the nearest hundred for >1k stars. + +--- + +## User Prompt + +``` +Here is the project list file from the awesome-note-taking repository. Please evaluate every single project against all 30 parameters and produce the full output (JSON + comparison table + statistics + recommendations). + +Process all projects. Take your time and be thorough. + +[Paste contents of projects.txt here, or attach the file] +``` + +--- + +## Usage Instructions + +### Option A: Single-Pass (for Claude Opus with large context) + +1. Copy the System Prompt section above into your Claude system prompt field +2. Paste the User Prompt with the contents of `projects.txt` +3. Attach the `parameters.md` file as additional reference +4. Run and wait for complete output + +### Option B: Batched Processing (recommended for reliability) + +Split projects into batches of ~15-20 and process each batch: + +``` +Evaluate projects 1-20 from the list. Output JSON + table rows for each. +[Paste first 20 project lines] +``` + +Continue until all projects are processed, then: + +``` +All projects have been evaluated. Now produce: +1. The complete condensed comparison table combining all batches +2. Summary statistics +3. Recommendations (remove, flag, update, missing projects) +``` + +### Option C: Automated via Agent + +Use an AI agent to automate the evaluation: +1. The agent reads `projects.txt` +2. For each project, uses web search and document fetching to gather data +3. Fills in parameters and writes results to a markdown file +4. Produces the final comparison table + +--- + +## Expected Output Size + +- JSON output: ~90 project objects x ~30 fields = ~2,700 lines +- Comparison table: ~95 rows +- Statistics: ~30 lines +- Recommendations: ~50-80 lines +- Total: approximately 3,000-4,000 lines + +## Quality Checklist + +After receiving results, verify: +- [ ] All projects have entries +- [ ] No fields are left completely empty (should be `?` or `—` or `N/A`) +- [ ] Star counts are roughly plausible (cross-check top 5) +- [ ] Activity status matches last commit dates +- [ ] No duplicate projects counted twice +- [ ] Abandoned projects are flagged +- [ ] Recommendations include missing popular tools diff --git a/docs/evaluation/parameters.md b/docs/evaluation/parameters.md new file mode 100644 index 0000000..6379362 --- /dev/null +++ b/docs/evaluation/parameters.md @@ -0,0 +1,115 @@ +# Awesome Note-Taking — Evaluation Parameters + +These parameters are designed to highlight **clear, meaningful differences** between note-taking projects when displayed in a simple comparison table. + +--- + +## Parameter Definitions + +### 1. Project Health & Activity + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 1 | **GitHub Stars** | Stars | Number (e.g., `35.2k`) | GitHub repo page | +| 2 | **Last Commit** | Last Commit | Date (`YYYY-MM`) or `archived` / `abandoned` | GitHub repo or release page | +| 3 | **Release Cadence** | Releases | `active` (<=3mo), `slow` (3-12mo), `stale` (>12mo), `none`, `archived` | GitHub releases tab | +| 4 | **Contributors** | Contributors | Number | GitHub contributors page | +| 5 | **Open Issues** | Open Issues | Number | GitHub issues tab | + +### 2. Licensing & Cost + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 6 | **License** | License | SPDX ID (e.g., `MIT`, `AGPL-3.0`, `GPL-3.0`, `Apache-2.0`) or `Proprietary` | GitHub repo or website | +| 7 | **Pricing Model** | Pricing | `free`, `freemium`, `paid`, `open-core`, `donation-based` | Website pricing page | +| 8 | **Free Tier Limits** | Free Limits | Brief description or `unlimited` or `N/A` | Website pricing page | + +### 3. Platform Support + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 9 | **Desktop Platforms** | Desktop | Comma-separated: `Win`, `Mac`, `Linux` or `—` if none | Website/downloads page | +| 10 | **Mobile Platforms** | Mobile | `Android`, `iOS`, `both`, `—` | App stores or website | +| 11 | **Web Access** | Web | `yes`, `self-hosted`, `—` | Website | +| 12 | **Browser Extension** | Extension | `yes`, `—` | Chrome/Firefox store | + +### 4. Data & Storage + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 13 | **Storage Format** | Storage | `plain-text/md`, `plain-text/org`, `plain-text/wiki`, `plain-text/other`, `sqlite`, `custom-db`, `proprietary`, `mixed` | Documentation | +| 14 | **Local-First** | Local-First | `yes` (data on device by default), `optional`, `no` (cloud-required) | Documentation | +| 15 | **Self-Hostable** | Self-Host | `yes`, `—` | Documentation | +| 16 | **Export Formats** | Export | Comma-separated: `md`, `pdf`, `html`, `json`, `txt`, `docx`, `enex`, `opml` or `—` | Documentation/features page | +| 17 | **Import From** | Import | Comma-separated known sources: `Evernote`, `Notion`, `Markdown`, `OPML`, etc. or `—` | Documentation | + +### 5. Sync & Collaboration + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 18 | **Built-in Sync** | Sync | `yes (proprietary)`, `yes (E2EE)`, `yes (self-hosted)`, `3rd-party only`, `git`, `—` | Features page | +| 19 | **E2E Encryption** | E2EE | `yes`, `optional`, `—` | Security documentation | +| 20 | **Real-time Collaboration** | Collab | `yes`, `—` | Features page | + +### 6. Core Features + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 21 | **Editor Type** | Editor | `WYSIWYG`, `markdown`, `block-based`, `outliner`, `rich-text`, `handwriting`, `hybrid` | Try the app or docs | +| 22 | **Markdown Support** | Markdown | `native`, `plugin`, `export-only`, `—` | Documentation | +| 23 | **Backlinks / Graph** | Backlinks | `yes`, `—` | Features page | +| 24 | **Tags / Folders** | Organization | `tags`, `folders`, `both`, `notebooks`, `outliner`, `other` | Features page | +| 25 | **Full-text Search** | Search | `yes`, `—` | Features page | +| 26 | **Plugin / Extension System** | Plugins | `yes (large ecosystem)`, `yes`, `limited`, `—` | Documentation | +| 27 | **API Available** | API | `yes`, `limited`, `—` | Developer documentation | +| 28 | **AI Features** | AI | `built-in`, `plugin`, `—` | Features/pricing page | +| 29 | **Offline Mode** | Offline | `full`, `partial`, `—` | Features page | + +### 7. Technology + +| # | Parameter | Column Header | Values | How to Check | +|---|-----------|---------------|--------|-------------| +| 30 | **Tech Stack / Framework** | Tech | e.g., `Electron/TypeScript`, `Tauri/Rust`, `Flutter/Dart`, `Native/C++`, `Web/React` | GitHub repo or docs | + +--- + +## Recommended Table Layout (Simplified) + +For the final awesome-list table, use this **condensed 15-column format** that maximizes differentiation: + +| Tool | Stars | Activity | License | Price | Desktop | Mobile | Web | Storage | Local | E2EE | Sync | Editor | Backlinks | Plugins | +|------|-------|----------|---------|-------|---------|--------|-----|---------|-------|------|------|--------|-----------|---------| + +### Column Definitions (Condensed) + +- **Stars** = GitHub stars (number) +- **Activity** = `green` active (commit <=3mo), `yellow` slow (3-12mo), `red` stale/archived (>12mo) +- **License** = SPDX or `Proprietary` +- **Price** = `Free`, `Freemium`, `Paid`, `Open-core` +- **Desktop** = `W` Win, `M` Mac, `L` Linux (e.g., `WML`) +- **Mobile** = `A` Android, `i` iOS (e.g., `Ai`) +- **Web** = `yes` / `SH` (self-hosted) / `—` +- **Storage** = `MD` markdown, `DB` database, `Org` org-mode, `Mix` +- **Local** = `yes` local-first / `cloud` cloud-required / `opt` optional +- **E2EE** = `yes` / `—` +- **Sync** = `yes` built-in / `Git` / `3P` third-party / `—` +- **Editor** = `MD` markdown, `WY` WYSIWYG, `BL` block, `OL` outliner, `RT` rich-text +- **Backlinks** = `yes` / `—` +- **Plugins** = `yes` / `—` + +--- + +## High-Differentiator Parameters + +These parameters create the **most visible contrast** between tools: + +1. **Local-First vs Cloud** — Biggest philosophical divide +2. **E2E Encryption** — Only ~20% of tools have it +3. **Backlinks / Graph View** — Separates PKM tools from simple notepads +4. **Plugin System** — Only ~30% have meaningful plugin ecosystems +5. **Self-Hostable** — Key for privacy-conscious users +6. **Activity Status** — Immediately flags abandoned projects +7. **Storage Format** — Plain-text vs proprietary is a major decision factor +8. **Pricing Model** — Free vs freemium vs paid +9. **Mobile Support** — Many desktop tools lack mobile apps +10. **Real-time Collaboration** — Separates team tools from personal tools diff --git a/docs/evaluation/projects.txt b/docs/evaluation/projects.txt new file mode 100644 index 0000000..0c80402 --- /dev/null +++ b/docs/evaluation/projects.txt @@ -0,0 +1,102 @@ +# Awesome Note-Taking - Project List +# Format: name|url|category +# Source: https://github.com/tehtbl/awesome-note-taking +# +AppFlowy|https://github.com/AppFlowy-IO/AppFlowy|Open Source > Native GUI +Cherrytree|http://www.giuspen.com/cherrytree|Open Source > Native GUI +DailyVox|https://github.com/intrepidkarthi/dailyvox|Open Source > Native GUI +Fluster|https://fluster-one.vercel.app|Open Source > Native GUI +GitJournal|https://github.com/GitJournal/GitJournal|Open Source > Native GUI +Leo|https://leo-editor.github.io/|Open Source > Native GUI +QOwnNotes|https://www.qownnotes.org/|Open Source > Native GUI +Red Notebook|https://rednotebook.app/|Open Source > Native GUI +Revu|https://github.com/JuliusBrussee/revu-swift|Open Source > Native GUI +Tomboy|https://wiki.gnome.org/Apps/Tomboy|Open Source > Native GUI +treesheets|https://github.com/aardappel/treesheets|Open Source > Native GUI +Zim Desktop Wiki|https://zim-wiki.org/|Open Source > Native GUI +IWE|https://github.com/iwe-org/iwe|Open Source > CLI +lifeos-cli|https://github.com/liujuanjuan1984/lifeos-cli|Open Source > CLI +nb|https://github.com/xwmx/nb|Open Source > CLI +todo-txt|https://github.com/todotxt/todo.txt-cli|Open Source > CLI +zk|https://github.com/mickael-menu/zk|Open Source > CLI +FuzPad|https://github.com/JianZcar/FuzPad|Open Source > TUI +Toney|https://github.com/SourcewareLab/Toney|Open Source > TUI +Deft|https://github.com/jrblevin/deft|Open Source > Editor Plugin +Emanote|https://github.com/srid/emanote|Open Source > Editor Plugin +Emacs|https://www.gnu.org/software/emacs/|Open Source > Editor Plugin +Foam|https://foambubble.github.io/|Open Source > Editor Plugin +howm|https://kaorahi.github.io/howm/|Open Source > Editor Plugin +Hyperbole/Koutliner|https://www.gnu.org/software/hyperbole/|Open Source > Editor Plugin +Org-brain|https://github.com/Kungsgeten/org-brain|Open Source > Editor Plugin +Org-mode|https://orgmode.org/|Open Source > Editor Plugin +Org-roam|https://www.orgroam.com/|Open Source > Editor Plugin +vim-wiki|https://github.com/vimwiki/vimwiki|Open Source > Editor Plugin +AFFiNE|https://github.com/toeverything/AFFiNE|Open Source > Electron +AnyType|https://anytype.io/|Open Source > Electron +Bangle.io|https://bangle.io|Open Source > Electron +btw|https://github.com/btw-so/btw|Open Source > Electron +Linked|https://github.com/lostdesign/linked|Open Source > Electron +Logseq|https://github.com/logseq/logseq|Open Source > Electron +Notable|https://notable.app/|Open Source > Electron +SiYuan|https://github.com/siyuan-note/siyuan|Open Source > Electron +Standard Notes|https://github.com/standardnotes/app|Open Source > Electron +SwarmVault|https://github.com/swarmclawai/swarmvault|Open Source > Electron +Tangent Notes|https://www.tangentnotes.com/|Open Source > Electron +TidGi|https://github.com/tiddly-gittly/TidGi-Desktop|Open Source > Electron +Zettlr|https://www.zettlr.com/|Open Source > Electron +Char|https://github.com/fastrepl/char|Open Source > Tauri +Inkwell|https://github.com/4worlds4w-svg/inkwell|Open Source > Tauri +Stik|https://github.com/0xMassi/stik_app|Open Source > Tauri +Treedome|https://codeberg.org/solver-orgz/treedome|Open Source > Tauri +CodiMD|https://github.com/hackmdio/codimd|Open Source > Web UI +Docmost|https://github.com/docmost/docmost|Open Source > Web UI +Dokuwiki|https://www.dokuwiki.org/dokuwiki|Open Source > Web UI +Ephe|https://github.com/unvalley/ephe|Open Source > Web UI +Flatnotes|https://github.com/dullage/flatnotes|Open Source > Web UI +Fossil|https://www2.fossil-scm.org/home/doc/trunk/www/index.wiki|Open Source > Web UI +HedgeDoc|https://github.com/hedgedoc/hedgedoc|Open Source > Web UI +Hypothes.is|https://hypothes.is/|Open Source > Web UI +Joplin|https://joplinapp.org/|Open Source > Web UI +Laverna|https://laverna.cc|Open Source > Web UI +Memos|https://github.com/usememos/memos|Open Source > Web UI +NattyNote|https://github.com/ahmedelq/NattyNote|Open Source > Web UI +Neuron|https://neuron.zettel.page/|Open Source > Web UI +Notesnook|https://github.com/streetwriters/notesnook|Open Source > Web UI +Outline|https://github.com/outline/outline|Open Source > Web UI +SilverBullet|https://github.com/silverbulletmd/silverbullet|Open Source > Web UI +Solo|https://github.com/johnSamilin/solo|Open Source > Web UI +TiddlyWiki|https://github.com/TiddlyWiki/TiddlyWiki5|Open Source > Web UI +Bear|https://bear.app/|Proprietary +Capacities|https://capacities.io/|Proprietary +Craft|https://www.craft.do/|Proprietary +DEVONthink|https://www.devontechnologies.com/apps/devonthink|Proprietary +Evernote|https://www.evernote.com|Proprietary +Google Keep|https://keep.google.com|Proprietary +HackMD|https://hackmd.io|Proprietary +Heptabase|https://heptabase.com/|Proprietary +Inkdrop|https://www.inkdrop.info|Proprietary +JournalCalls|https://journalcalls.com|Proprietary +MDLook|https://mdlook.com|Proprietary +Mem|https://get.mem.ai/|Proprietary +MindMirror|https://mindmirror.app|Proprietary +MindWork|https://mindwork.it.com/|Proprietary +Notion|https://notion.so|Proprietary +NotePlan|https://noteplan.co|Proprietary +Notebook|https://www.zoho.com/notebook|Proprietary +Obsidian|https://obsidian.md/|Proprietary +Octarine|https://octarine.app/|Proprietary +OktoNote|https://oktonote.app|Proprietary +OneNote|https://www.onenote.com|Proprietary +Polar|https://getpolarized.io/|Proprietary +Reflect|https://reflect.app/|Proprietary +Roam|https://roamresearch.com/|Proprietary +Simplenote|http://simplenote.com|Proprietary +Somnote|http://somcloud.com/about/somnote|Proprietary +Squid|http://squidnotes.com|Proprietary +Supernotes|https://supernotes.app|Proprietary +Tana|https://tana.inc/|Proprietary +Taskade|https://www.taskade.com|Proprietary +TheBrain|https://www.thebrain.com/|Proprietary +Ulysses|https://ulysses.app/|Proprietary +Workflowy|https://workflowy.com|Proprietary +Wridea|http://wridea.com|Proprietary From 94d262c3621c3d3f50fe39576413ecc8950898b3 Mon Sep 17 00:00:00 2001 From: tehtbl <3999809+tehtbl@users.noreply.github.com> Date: Wed, 15 Apr 2026 19:47:49 +0200 Subject: [PATCH 03/12] feat: add license/tech tags, new icons, 15 missing tools, remove duplicates MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Convert legend to table format with new icons (iOS, E2EE, archived) - Add license (SPDX) and tech stack tags to all open-source entries - Add new icons to all entries based on per-project research: - iOS (🍎): AppFlowy, GitJournal, DailyVox, Joplin, Standard Notes, Logseq, SiYuan, AnyType, Char, Notesnook, Obsidian, Inkdrop, and more - E2EE (🔒): Standard Notes, AnyType, Joplin, Notesnook, Obsidian Sync, Inkdrop, Reflect - Archived (⚠️): Tomboy, Org-brain, Notable, CodiMD, Laverna, Neuron, Wridea, Polar, OktoNote - Add 6 missing open-source Web UI tools: Outline, Memos, HedgeDoc, Flatnotes, Docmost, Notesnook - Add 9 missing proprietary tools: Notion, Craft, Bear, Capacities, Heptabase, Tana, Reflect, Mem, Ulysses - Remove duplicate AppFlowy from Electron section - Fix typo "Zim Deskop Wiki" -> "Zim Desktop Wiki" - Fix contradictory icons on Supernotes and MindMirror - Fix "Emanate" -> "Emanote", fix "Succesor" -> "Successor" - Fix JournalCalls incorrect Android icon (phone service, no native app) - Remove "Archived" text from Standard Notes description - Add missing dash before Fossil and Org-mode descriptions --- README.md | 206 +++++++++++++++++++++++++++++------------------------- 1 file changed, 111 insertions(+), 95 deletions(-) diff --git a/README.md b/README.md index d5aecba..920e874 100644 --- a/README.md +++ b/README.md @@ -4,15 +4,16 @@ ## Legend -📖 notes are stored in plain text format (e.g. Markdown, org-mode, dokuwiki) - -📕 notes are stored in a database or otherwise need an export for external use - -🤖 Android support or app. Alternatively, see [termux](https://termux.dev/) for CLI (including emacs and vim plugins) on Android devices. - -👍 Recommended. In active use for many years by a pull-request author. - -🔁 provides multi-device sync. Alternatively, see [syncthing](https://syncthing.net/) or any cloud provider +| Icon | Meaning | +|:----:|:--------| +| 📖 | Notes stored in **plain text** (Markdown, org-mode, wiki, etc.) | +| 📕 | Notes stored in a **database** or proprietary format | +| 🤖 | **Android** support or app (see also [Termux](https://termux.dev/) for CLI tools) | +| 🍎 | **iOS** support or app | +| 👍 | **Recommended** — in active use for years by a PR author | +| 🔁 | Built-in **multi-device sync** (alternatively: [Syncthing](https://syncthing.net/) or any cloud provider) | +| 🔒 | **End-to-end encryption** support | +| ⚠️ | **Archived / abandoned** — kept for reference but no longer maintained | ## Contents @@ -29,111 +30,126 @@ ### Native GUI -- 📕 [AppFlowy](https://github.com/AppFlowy-IO/AppFlowy) - The Open Source Alternative To Notion.Supports macOS, Windows & Linux (rust+flutter). -- 📖 [QOwnNotes](https://www.qownnotes.org/) - Open source plain-text file markdown note-taking native-application with Nextcloud / ownCloud integration. -- 📕 [Cherrytree](http://www.giuspen.com/cherrytree) - A hierarchical note-taking app, featuring rich text and syntax highlighting. -- 📕 [treesheets](https://github.com/aardappel/treesheets) - Free Form Data Organizer using hierarchical spreadsheet. Open source native desktop application. -- 📖 [Zim Deskop Wiki](https://zim-wiki.org/) - Open source multi-platform native desktop GUI to manage a collection of local wiki pages. -- 📕 [Leo](https://leo-editor.github.io/) - PIM, IDE and outliner that accelerates the work flow of programmers, authors and web designers. Open source native desktop app. -- 🤖🔁 [Tomboy](https://wiki.gnome.org/Apps/Tomboy) - GNOME desktop note-taking application for Linux, Windows, and macOS. -- 📖 [Red Notebook](https://rednotebook.app/) - Open source native desktop journal using plain-text files. -- 📖🤖 [GitJournal](https://github.com/GitJournal/GitJournal) - Open source markdown notes editor with integrated syncing with Git. Supports iOS, Android, Linux and MacOS (flutter). -- [Fluster](https://fluster-one.vercel.app) - All in one note taking solution for modern students and academics. Powered by Rust with integrated AI. -- 📕🔁 [DailyVox](https://github.com/intrepidkarthi/dailyvox) - Free AI voice diary for iOS with on-device transcription, mood tracking, Digital Twin, and knowledge graph. 100% offline, optional iCloud sync (swift/swiftui). -- 📕 [Revu](https://github.com/JuliusBrussee/revu-swift) - Local-first spaced repetition note-taking app for macOS with FSRS scheduling, Notion-inspired UI, Anki import, study guides, and exams. Built with SwiftUI. +- 📕🍎🤖🔁 [AppFlowy](https://github.com/AppFlowy-IO/AppFlowy) - Open source alternative to Notion. Supports macOS, Windows, Linux, iOS, and Android. `AGPL-3.0` `Flutter/Dart` +- 📕 [Cherrytree](http://www.giuspen.com/cherrytree) - A hierarchical note-taking app featuring rich text and syntax highlighting. `GPL-3.0` `Qt/C++` +- 📕🍎🔁 [DailyVox](https://github.com/intrepidkarthi/dailyvox) - Free AI voice diary for iOS with on-device transcription, mood tracking, Digital Twin, and knowledge graph. 100% offline, optional iCloud sync. `MIT` `Swift/SwiftUI` +- 📖 [Fluster](https://fluster-one.vercel.app) - All-in-one note-taking solution for modern students and academics, powered by Rust with integrated AI. `?` `Rust/TypeScript` +- 📖🍎🤖🔁 [GitJournal](https://github.com/GitJournal/GitJournal) - Open source markdown notes editor with integrated Git syncing. Supports iOS, Android, Linux, and macOS. `AGPL-3.0` `Flutter/Dart` +- 📖 [Leo](https://leo-editor.github.io/) - PIM, IDE, and outliner that accelerates the work flow of programmers, authors, and web designers. `MIT` `Python` +- 📖 [QOwnNotes](https://www.qownnotes.org/) - Open source plain-text file markdown note-taking application with Nextcloud / ownCloud integration. `GPL-2.0` `Qt/C++` +- 📖 [Red Notebook](https://rednotebook.app/) - Open source desktop journal using plain-text files. `GPL-2.0` `Python/GTK` +- 📕 [Revu](https://github.com/JuliusBrussee/revu-swift) - Local-first spaced repetition note-taking app for macOS with FSRS scheduling, Anki import, and study guides. `GPL-3.0` `Swift/SwiftUI` +- 🤖🔁⚠️ [Tomboy](https://wiki.gnome.org/Apps/Tomboy) - GNOME desktop note-taking application for Linux, Windows, and macOS. Original project abandoned; see [tomboy-ng](https://github.com/tomboy-notes/tomboy-ng) for the active successor. `LGPL-2.1` `C#/Mono` +- 📕 [treesheets](https://github.com/aardappel/treesheets) - Free form data organizer using hierarchical spreadsheet. `Zlib` `C++` +- 📖 [Zim Desktop Wiki](https://zim-wiki.org/) - Open source multi-platform desktop GUI to manage a collection of local wiki pages. `GPL-2.0` `Python/GTK` ### CLI -- 📖 [todo-txt](https://github.com/todotxt/todo.txt-cli) - A simple and extensible shell script for managing your todo.txt file. -- 📖 [zk](https://github.com/mickael-menu/zk) - A command-line tool helping you to maintain a plain text Zettelkasten or personal wiki. -- [nb](https://github.com/xwmx/nb) - A command line and local web note‑taking, bookmarking, archiving, and knowledge base application -- 📖 [IWE](https://github.com/iwe-org/iwe) - A markdown-based knowledge management tool with CLI and LSP server. Turns markdown files into a navigable graph with backlinks, link completion, and code actions. Works with VS Code, Neovim, Zed, and Helix. -- 📕 [lifeos-cli](https://github.com/liujuanjuan1984/lifeos-cli) - A terminal-native LifeOS for notes, linked tasks, schedules, events, and timelogs. +- 📖 [IWE](https://github.com/iwe-org/iwe) - A markdown-based knowledge management tool with CLI and LSP server. Turns markdown files into a navigable graph with backlinks and link completion. Works with VS Code, Neovim, Zed, and Helix. `Apache-2.0` `Rust` +- 📕 [lifeos-cli](https://github.com/liujuanjuan1984/lifeos-cli) - A terminal-native LifeOS for notes, linked tasks, schedules, events, and timelogs. `Apache-2.0` `Python` +- 📖 [nb](https://github.com/xwmx/nb) - A command line and local web note-taking, bookmarking, archiving, and knowledge base application. `AGPL-3.0` `Shell` +- 📖 [todo-txt](https://github.com/todotxt/todo.txt-cli) - A simple and extensible shell script for managing your todo.txt file. `GPL-3.0` `Shell` +- 📖 [zk](https://github.com/mickael-menu/zk) - A command-line tool helping you to maintain a plain text Zettelkasten or personal wiki. `GPL-3.0` `Go` ### TUI -- 📖 [FuzPad](https://github.com/JianZcar/FuzPad) - A minimalistic note management solution. Powered by fzf. -- 📖 [Toney](https://github.com/SourcewareLab/Toney) - Toney is a fast, lightweight, terminal-based note-taking app for the modern developer. +- 📖 [FuzPad](https://github.com/JianZcar/FuzPad) - A minimalistic note management solution powered by fzf. `GPL-3.0` `Shell` +- 📖 [Toney](https://github.com/SourcewareLab/Toney) - A fast, lightweight, terminal-based note-taking app for the modern developer. `MIT` `Go` ### Editor Plugin -- Visual Studio Code - Microsoft text editor - - [Foam](https://foambubble.github.io/) - VSCode plugin inspired by Roam Research. - - [Emanate](https://github.com/srid/emanote) - A structured view of your plain-text notes. Succesor to neuron. -- 🤖 [Emacs](https://www.gnu.org/software/emacs/) - An open source, cross-platform, extensible, and customizable text editor. - - 📖 [Org-mode](https://orgmode.org/) plain-text markup and major mode for keeping notes, authoring documents, computational notebooks, literate programming, … - - 📖 [Org-roam](https://www.orgroam.com/) - plain-text personal knowledge management system inspired by roam research. - - 📖 [Org-brain](https://github.com/Kungsgeten/org-brain) - Concept mapping in Emacs using org-mode. - - 📖 [Deft](https://github.com/jrblevin/deft) - an Emacs mode for quickly browsing, filtering, and editing directories of plain text notes, inspired by Notational Velocity. - - 📖 [Hyperbole/Koutliner](https://www.gnu.org/software/hyperbole/) - multi-level autonumbered hypertextual outliner - - 📖 [howm](https://kaorahi.github.io/howm/) - Note-taking tool on Emacs that can be combined with any format. -- 📖 [vim-wiki](https://github.com/vimwiki/vimwiki) - A personal wiki for Vim -- a number of linked text files that have their own syntax highlighting. +- Visual Studio Code - Microsoft text editor. + - 📖 [Foam](https://foambubble.github.io/) - VSCode plugin for personal knowledge management inspired by Roam Research. `MIT` `TypeScript/VSCode` + - 📖 [Emanote](https://github.com/srid/emanote) - A structured view of your plain-text notes. Successor to Neuron. `AGPL-3.0` `Haskell` +- 🤖 [Emacs](https://www.gnu.org/software/emacs/) - An open source, cross-platform, extensible, and customizable text editor. `GPL-3.0` `C/Emacs Lisp` + - 📖⚠️ [Org-brain](https://github.com/Kungsgeten/org-brain) - Concept mapping in Emacs using org-mode. Last commit 2023; appears unmaintained. `MIT` `Emacs Lisp` + - 📖 [Org-mode](https://orgmode.org/) - Plain-text markup and major mode for keeping notes, authoring documents, computational notebooks, and literate programming. `GPL-3.0` `Emacs Lisp` + - 📖 [Org-roam](https://www.orgroam.com/) - Plain-text personal knowledge management system inspired by Roam Research. `GPL-3.0` `Emacs Lisp` + - 📖 [Deft](https://github.com/jrblevin/deft) - An Emacs mode for quickly browsing, filtering, and editing directories of plain text notes, inspired by Notational Velocity. `BSD-3-Clause` `Emacs Lisp` + - 📖 [Hyperbole/Koutliner](https://www.gnu.org/software/hyperbole/) - Multi-level autonumbered hypertextual outliner for Emacs. `GPL-3.0` `Emacs Lisp` + - 📖 [howm](https://kaorahi.github.io/howm/) - Note-taking tool on Emacs that can be combined with any format. `GPL-2.0` `Emacs Lisp` +- 📖 [vim-wiki](https://github.com/vimwiki/vimwiki) - A personal wiki for Vim — a number of linked text files with their own syntax highlighting. `MIT` `Vim Script` ### Electron -* [Logseq](https://github.com/logseq/logseq) - Local-first, non-linear, outliner notebook for organizing and sharing your personal knowledge base. -* 📕🤖🔁 [SiYuan](https://github.com/siyuan-note/siyuan) - A privacy-first, self-hosted, fully open source personal knowledge management software. -* [Zettlr](https://www.zettlr.com/) - Markdown Editor for the 21st century. -* 🤖🔁 [Standard Notes](https://github.com/standardnotes/app) - A free, open-source, and completely encrypted notes app. macOS, Windows, & Linux app repository. Archived -* [AnyType](https://anytype.io/) - Open source local-first electron and phone app for tasks, notes, and more. -* [Bangle.io](https://bangle.io) - A free alternative to Notion that takes markdown notes saved right in your computer -* [Linked](https://github.com/lostdesign/linked) - Forget less by daily journaling, completely offline, secure and free. Supports macOS, Windows & Linux. -* [AppFlowy](https://github.com/AppFlowy-IO/AppFlowy) - The Open Source Alternative To Notion.Supports macOS, Windows & Linux. -* [btw](https://github.com/btw-so/btw) - btw is an open source personal website builder. -* 📖🤖🔁 [TidGi](https://github.com/tiddly-gittly/TidGi-Desktop) - Customizable personal knowledge-base with git as backup manager and blogging platform. A TiddlyWiki app based on TiddlyWiki platfrom. -* 📕🔁 [AFFiNE](https://github.com/toeverything/AFFiNE) - Next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use. -* 📖 [Tangent Notes](https://www.tangentnotes.com/) - An open source, local-first markdown note taking application designed to let you write the way you think. -* [Notable](https://notable.app/) - Free app for simple note taking based on VS Code Editor. _Important:_ Notable is no longer Open Source as of Sep 28, 2019 (v1.8.4 / [7403a47](https://github.com/notable/notable/commit/7403a47f7602860d227268dda08e3b6f504fd30c)) -* [SwarmVault](https://github.com/swarmclawai/swarmvault) - Local-first RAG knowledge base compiler. Persistent markdown wiki, knowledge graph, hybrid SQLite FTS + embeddings, contradiction detection, and built-in MCP server. + +- 📕🔁 [AFFiNE](https://github.com/toeverything/AFFiNE) - Next-gen knowledge base that brings planning, sorting, and creating all together. Privacy first, open-source, customizable and ready to use. `MIT` `Electron/TypeScript` +- 📕🍎🤖🔒🔁 [AnyType](https://anytype.io/) - Open source local-first app for tasks, notes, and more with E2EE and cross-platform sync. `Source-available` `Electron/TypeScript` +- 📖 [Bangle.io](https://bangle.io) - A free alternative to Notion that takes markdown notes saved right on your computer. `AGPL-3.0` `Web/TypeScript` +- 📖 [btw](https://github.com/btw-so/btw) - Open source personal website builder. `GPL-3.0` `Electron/JavaScript` +- 📖 [Linked](https://github.com/lostdesign/linked) - Forget less by daily journaling, completely offline, secure, and free. Supports macOS, Windows, and Linux. `GPL-3.0` `Electron/TypeScript` +- 📖🍎🤖🔁 [Logseq](https://github.com/logseq/logseq) - Local-first, non-linear, outliner notebook for organizing and sharing your personal knowledge base. `AGPL-3.0` `Electron/ClojureScript` +- ⚠️ [Notable](https://notable.app/) - Simple note-taking app based on VS Code Editor. No longer open source as of v1.6. `Proprietary` `Electron/TypeScript` +- 📕🍎🤖🔁 [SiYuan](https://github.com/siyuan-note/siyuan) - A privacy-first, self-hosted, fully open source personal knowledge management software. `AGPL-3.0` `Electron/TypeScript+Go` +- 📖🍎🤖🔒🔁 [Standard Notes](https://github.com/standardnotes/app) - A free, open-source, and completely encrypted notes app for macOS, Windows, Linux, iOS, and Android. `AGPL-3.0` `Electron/TypeScript` +- 📖 [SwarmVault](https://github.com/swarmclawai/swarmvault) - Local-first RAG knowledge base compiler with persistent markdown wiki, knowledge graph, hybrid SQLite FTS and embeddings, contradiction detection, and built-in MCP server. `MIT` `Node.js/TypeScript` +- 📖 [Tangent Notes](https://www.tangentnotes.com/) - An open source, local-first markdown note taking application designed to let you write the way you think. `Apache-2.0` `Electron/TypeScript` +- 📖🤖🔁 [TidGi](https://github.com/tiddly-gittly/TidGi-Desktop) - Customizable personal knowledge-base with git as backup manager and blogging platform, based on TiddlyWiki. `MPL-2.0` `Electron/TypeScript` +- 📖 [Zettlr](https://www.zettlr.com/) - Markdown editor for academics and researchers. `GPL-3.0` `Electron/TypeScript` ### Tauri -* 📕 [Treedome](https://codeberg.org/solver-orgz/treedome) - Open-source and local-first, encrypted, note taking application organized in tree-like structures. -* 📖 [Stik](https://github.com/0xMassi/stik_app) - Instant thought capture for macOS. Global hotkey summons a post-it note, type and close. Notes stored as plain markdown files. -* [Char](https://github.com/fastrepl/char) - Open-source AI notepad for meetings with flexible AI stack and on-device storage. -* 📖 [Inkwell](https://github.com/4worlds4w-svg/inkwell) - Portable Markdown editor with split view, live preview, themes, templates, focus mode, typewriter mode, find & replace, and diff viewer. +- 📖🍎 [Char](https://github.com/fastrepl/char) - Open-source AI notepad for meetings with flexible AI stack and on-device storage. `GPL-3.0` `Tauri/Rust+TypeScript` +- 📖 [Inkwell](https://github.com/4worlds4w-svg/inkwell) - Portable Markdown editor with split view, live preview, themes, templates, focus mode, and diff viewer. `Source-available` `Tauri/Rust` +- 📖 [Stik](https://github.com/0xMassi/stik_app) - Instant thought capture for macOS. Global hotkey summons a post-it note, type and close. Notes stored as plain markdown files. `MIT` `Tauri/TypeScript+Rust` +- 📕 [Treedome](https://codeberg.org/solver-orgz/treedome) - Open-source and local-first, encrypted note-taking application organized in tree-like structures. `AGPL-3.0` `Tauri/Rust` ### Web UI -* 📖🤖🔁 [Joplin](https://joplinapp.org/) - Open source note taking app that supports synchronization and has Windows, Linux, Android, Cli builds. Supports import from Evernote. -* 📕 [Laverna](https://laverna.cc) - Evernote like note-taking web application with a Markdown editor using indexedDB local storage. -* 📖 [CodiMD](https://github.com/hackmdio/codimd) - CodiMD is the free software version of HackMD with reduced features (without book mode). -* 📖 [Dokuwiki](https://www.dokuwiki.org/dokuwiki) - a simple to use and highly versatile Open Source wiki software that doesn't require a database. -* 📕 [Hypothes.is](https://hypothes.is/) - Annotate anything online. -* [NattyNote](https://github.com/ahmedelq/NattyNote) - A free, open-source browser extension to take time-stamped YouTube notes. -* 📖 [Fossil](https://www2.fossil-scm.org/home/doc/trunk/www/index.wiki) source control software with built-in stand-alone wiki pages. -* 📖 [SilverBullet](https://github.com/silverbulletmd/silverbullet) - Free, open-source self-hosted PWA for markdown notes. -* 📖 [TiddlyWiki](https://github.com/TiddlyWiki/TiddlyWiki5) - A self-contained JavaScript wiki for the browser, Node.js, AWS Lambda etc. -* 📕 [Solo](https://github.com/johnSamilin/solo) - Minimalistic private note-taking app with focus on typography -* 📖 [Ephe](https://github.com/unvalley/ephe) - A Markdown Paper for daily todo and thoughts. Privacy first, OSS, local-only. - -* [Neuron](https://neuron.zettel.page/) - Future-proof open-source app for managing your plain-text notes in Zettelkasten style. Superceeded by Emanote. + +- 📖⚠️ [CodiMD](https://github.com/hackmdio/codimd) - The free software version of HackMD. See [HedgeDoc](https://hedgedoc.org/) for the active community fork. `AGPL-3.0` `Web/JavaScript` +- 📖 [Docmost](https://github.com/docmost/docmost) - Open-source collaborative wiki and documentation software. Notion/Confluence alternative with real-time collaboration. `AGPL-3.0` `Web/TypeScript` +- 📖 [Dokuwiki](https://www.dokuwiki.org/dokuwiki) - A simple to use and highly versatile open source wiki software that doesn't require a database. `GPL-2.0` `Web/PHP` +- 📖 [Ephe](https://github.com/unvalley/ephe) - A Markdown paper for daily todo and thoughts. Privacy first, OSS, local-only. `MIT` `Web/TypeScript` +- 📖 [Flatnotes](https://github.com/dullage/flatnotes) - Self-hosted, database-less, plain-text markdown note-taking app. `MIT` `Python/Vue` +- 📖 [Fossil](https://www2.fossil-scm.org/home/doc/trunk/www/index.wiki) - Source control software with built-in standalone wiki pages. `BSD-2-Clause` `C` +- 📖 [HedgeDoc](https://github.com/hedgedoc/hedgedoc) - Real-time collaborative markdown notes. Community successor to CodiMD. `AGPL-3.0` `Web/TypeScript` +- 📕 [Hypothes.is](https://hypothes.is/) - Annotate anything online. `BSD-2-Clause` `Web/Python` +- 📖🍎🤖🔒🔁 [Joplin](https://joplinapp.org/) - Open source note taking app that supports synchronization with E2EE. Available on Windows, Linux, macOS, iOS, Android, and CLI. Supports import from Evernote. `AGPL-3.0` `Electron+React Native/TypeScript` +- 📕⚠️ [Laverna](https://laverna.cc) - Evernote-like note-taking web application with a Markdown editor. Abandoned since 2018. `MPL-2.0` `Web/JavaScript` +- 📖🔁 [Memos](https://github.com/usememos/memos) - Lightweight, self-hosted memo hub. Privacy first. `MIT` `Go/React` +- 📖 [NattyNote](https://github.com/ahmedelq/NattyNote) - A free, open-source browser extension to take time-stamped YouTube notes. `GPL-3.0` `Browser Extension/JavaScript` +- 📖⚠️ [Neuron](https://neuron.zettel.page/) - Open-source app for managing plain-text notes in Zettelkasten style. Superseded by Emanote. `AGPL-3.0` `Haskell` +- 📖🍎🤖🔒🔁 [Notesnook](https://github.com/streetwriters/notesnook) - Fully open source and end-to-end encrypted note-taking app available on all platforms. `GPL-3.0` `Web/TypeScript` +- 📖 [Outline](https://github.com/outline/outline) - Fast, collaborative team knowledge base. Self-hosted or cloud. `BSL-1.1` `Web/TypeScript` +- 📖 [SilverBullet](https://github.com/silverbulletmd/silverbullet) - Free, open-source self-hosted PWA for markdown notes. `MIT` `TypeScript/Go` +- 📕 [Solo](https://github.com/johnSamilin/solo) - Minimalistic private note-taking app with focus on typography. `MIT` `Web/TypeScript` +- 📖 [TiddlyWiki](https://github.com/TiddlyWiki/TiddlyWiki5) - A self-contained JavaScript wiki for the browser, Node.js, AWS Lambda, and more. `BSD-3-Clause` `Web/JavaScript` ## Proprietary -* 📖 [Obsidian](https://obsidian.md/) - Free for personal use app, that works on top of a local folder of plain text Markdown files. -* [Wridea](http://wridea.com) - Web service to organize and improve ideas and notes by sharing with friends and necessary tools. -* [Google Keep](https://keep.google.com) - Google Keep is a note-taking service developed by Google. It is available on the web and as mobile app. -* [OneNote](https://www.onenote.com) - Microsoft OneNote is a program for free-form information gathering and multi-user collaboration. -* [Notebook](https://www.zoho.com/notebook) - Mobile/Web/Desktop app to take multiple forms of notes from Zoho. -* [Simplenote](http://simplenote.com) - Available for iOS, Android, macOS, Windows, Linux, and the web and supports Markdown. -* [Somnote](http://somcloud.com/about/somnote) - Record and save important information, ideas, and moments. Available for multiple platforms. -* [Squid](http://squidnotes.com) - Android app to take digital handwritten notes for class, work, or fun! Markup PDFs and sign documents. -* [HackMD](https://hackmd.io) - HackMD helps developers write better documents and build active communities with open collaboration. -* [Evernote](https://www.evernote.com) - An (online) app designed for note-taking, organizing, task management, and archiving of different formats. -* [Inkdrop](https://www.inkdrop.info) - An (online) app for organizing Markdown notes. -* [Workflowy](https://workflowy.com) - WorkFlowy is a web-based organizational tool to create todo lists, notes, team projects and others. -* [DEVONthink](https://www.devontechnologies.com/apps/devonthink) - macOS or iPhone app with lots of features that can handle many files. -* [Roam](https://roamresearch.com/) - A note-taking tool for networked thought. -* [TheBrain](https://www.thebrain.com/) - Mind mapping and personal knowledge base software application. -* [Polar](https://getpolarized.io/) - An integrated reading environment to build your knowledge base. -* 📖📕🤖🔁 [Supernotes](https://supernotes.app) – A multi-platform notes app built around markdown notecards and card nesting with real-time collaborative features. -* [NotePlan](https://noteplan.co) - NotePlan combines tasks, notes, and calendar - all in one place. It is available on Web, MacOS and iOS. -* 📕🤖🔁 [JournalCalls](https://journalcalls.com) - Voice journal/note taking over a phone call, exports to markdown and Notion -* 📕🤖🔁 [Taskade](https://www.taskade.com) – A tree-structured note-taking and productivity app for individuals and teams. Features real-time collaboration, AI agents, automation, and multiple views (List, Board, Calendar, Mind Map, Table, etc.). Available on Web, macOS, Windows, iOS, Android, and browser extensions. -* [OktoNote](https://oktonote.app) - An AI first note taking app that lets you fire and forget. It auto organizes your notes for you in beautiful, actionable and searchable cards. Supports text, audio, photos and documents. Perfect for journals, tasks, travel itinerary and tickets, lists, things to remember, bookmarking, study notes, discussion notes etc., Available on Ios for now, launching soon on Android and Web. -* 📖 [Octarine](https://octarine.app/) - A fast, lightweight tool for writing, planning, and organizing — in Markdown that stays yours. -* 📖 [MDLook](https://mdlook.com) ([GitHub](https://github.com/djosci/MDLook)) - Portable offline Markdown editor for Windows using WebView2, with live preview, dark mode, KaTeX math, and Mermaid diagrams. -* 📕📖🔁 [MindMirror](https://mindmirror.app) - Note app for busy minds, write down your thoughts or transform your thoughts into notes then ask away, and MindMirror will find exactly what you are looking for. -* 📕 [MindWork](https://mindwork.it.com/) - A Cursor-like AI workspace for deep and focused personal knowledge management. +- 📖🍎 [Bear](https://bear.app/) - Beautiful, flexible writing app for notes and prose. Apple platforms only (Mac, iPhone, iPad). Sync via iCloud with Bear Pro. +- 📕🍎🤖🔁 [Capacities](https://capacities.io/) - Object-based note-taking app for networked thinking. Available on macOS, Windows, Linux, web, iOS, and Android. +- 📕🍎🤖🔁 [Craft](https://www.craft.do/) - Beautiful native document editor for Mac, iPad, iPhone, Android, and Windows with real-time collaboration. +- 📕🍎🔁 [DEVONthink](https://www.devontechnologies.com/apps/devonthink) - macOS and iOS app for storing, organizing, and working on documents and notes. +- 📕🍎🤖🔁 [Evernote](https://www.evernote.com) - An app designed for note-taking, organizing, task management, and archiving of different formats. +- 📕🍎🤖🔁 [Google Keep](https://keep.google.com) - Google Keep is a note-taking service developed by Google. Available on the web and as a mobile app. +- 📖 [HackMD](https://hackmd.io) - Helps developers write better documents and build active communities with open collaboration. +- 📕🍎🤖🔁 [Heptabase](https://heptabase.com/) - Visual note-taking tool for learning complex topics, with whiteboard-based card organization. +- 📕🍎🤖🔒🔁 [Inkdrop](https://www.inkdrop.info) - An app for organizing Markdown notes with E2EE sync. Available on macOS, Windows, Linux, iOS, and Android. +- 📕🔁 [JournalCalls](https://journalcalls.com) - Voice journal and note-taking over a phone call. Exports to Markdown and Notion. +- 📖 [MDLook](https://mdlook.com) ([GitHub](https://github.com/djosci/MDLook)) - Portable offline Markdown editor for Windows using WebView2, with live preview, dark mode, KaTeX math, and Mermaid diagrams. +- 📕🍎🔁 [Mem](https://get.mem.ai/) - AI-powered self-organizing workspace for notes and knowledge. Available on web and iOS. +- 📕🍎🔁 [MindMirror](https://mindmirror.app) - Note app for busy minds with AI search and smart organization. iOS available, Android coming soon. +- 📕🔁 [MindWork](https://mindwork.it.com/) - A Cursor-like AI workspace for deep and focused personal knowledge management. +- 📕🍎🤖🔁 [Notion](https://notion.so) - All-in-one workspace for notes, docs, wikis, projects, and collaboration. +- 📖🍎🔁 [NotePlan](https://noteplan.co) - Combines tasks, notes, and calendar all in one place. Available on Mac and iOS. +- 📕🍎🤖🔁 [Notebook](https://www.zoho.com/notebook) - Mobile, web, and desktop app to take multiple forms of notes, from Zoho. +- 📖🍎🔒🔁 [Obsidian](https://obsidian.md/) - Free for personal use app that works on top of a local folder of plain text Markdown files. Optional E2EE sync via Obsidian Sync. +- 📖 [Octarine](https://octarine.app/) - A fast, lightweight tool for writing, planning, and organizing in Markdown that stays yours. +- ⚠️ [OktoNote](https://oktonote.app) - An AI-first note-taking app that auto-organizes notes into searchable cards. Website unreachable; status unclear. +- 📕🍎🤖🔁 [OneNote](https://www.onenote.com) - Microsoft OneNote is a program for free-form information gathering and multi-user collaboration. +- ⚠️ [Polar](https://getpolarized.io/) - An integrated reading environment to build your knowledge base. Website unreachable; appears abandoned. +- 📕🍎🔒🔁 [Reflect](https://reflect.app/) - Fast, AI-powered note-taking app with end-to-end encryption. Available on Mac, Windows, web, and iOS. +- 📖🔁 [Roam](https://roamresearch.com/) - A note-taking tool for networked thought. +- 📖🍎🤖🔁 [Simplenote](http://simplenote.com) - Available for iOS, Android, macOS, Windows, Linux, and the web. Supports Markdown. +- 📕🍎🤖🔁 [Somnote](http://somcloud.com/about/somnote) - Record and save important information, ideas, and moments. Available for multiple platforms. +- 🤖 [Squid](http://squidnotes.com) - Android app to take digital handwritten notes for class, work, or fun. Markup PDFs and sign documents. +- 📕🍎🤖🔁 [Supernotes](https://supernotes.app) - A multi-platform notes app built around markdown notecards and card nesting with real-time collaborative features. +- 📕🍎🤖🔁 [Tana](https://tana.inc/) - Supertag-based knowledge tool with powerful structuring and AI-meeting features. +- 📕🍎🤖🔁 [Taskade](https://www.taskade.com) - A tree-structured note-taking and productivity app with real-time collaboration, AI agents, and multiple views. Available on web, macOS, Windows, iOS, Android, and browser extensions. +- 📕🍎🤖🔁 [TheBrain](https://www.thebrain.com/) - Mind mapping and personal knowledge base software application. +- 📖🍎🔁 [Ulysses](https://ulysses.app/) - Premium writing app for Mac, iPad, and iPhone with Markdown support. Apple platforms only. +- 📕🍎🤖🔁 [Workflowy](https://workflowy.com) - Web-based organizational tool to create todo lists, notes, team projects, and more. +- ⚠️ [Wridea](http://wridea.com) - Web service to organize and improve ideas and notes by sharing with friends. Website appears dead. ## Contributing From 7f8bcf50f3ed9714f0a27bf78f97ac8f69ff6d56 Mon Sep 17 00:00:00 2001 From: tehtbl <3999809+tehtbl@users.noreply.github.com> Date: Wed, 15 Apr 2026 19:48:12 +0200 Subject: [PATCH 04/12] feat: add branded header with badges and intro paragraph - Replace plain title with centered div containing logo, tagline, and badge row - Badges: awesome, stars, last-commit, contributors, project count (100+) - Add welcoming intro paragraph explaining the list and CTA to contribute --- README.md | 24 +++++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 920e874..bc123a9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,24 @@ -# Awesome Note-Taking [](https://awesome.re) - -> A curated list of awesome note-taking software. +
The most comprehensive, community-curated collection of note-taking tools.
+ Open source & proprietary — organized, rated, and actively maintained.