# batnoter/batnoter

An open source, markdown-based, self-hosted note taking webapp.

Repository: https://github.com/batnoter/batnoter
Canonical: https://ross.abutalabs.com/products/batnoter
Homepage: https://batnoter.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: notes, git, github, markdown, productivity, react, webapp, contributions-welcome, reactjs, container-ready, note, note-app, note-taking, mui, typescript
Last push: 2022-10-01T08:12:00+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 1636, "days_push": 1432, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2420, forks 153 (observed 2026-08-28T04:06:50.510478+00:00)

## What it is
BatNoter is an open-source, self-hosted markdown note-taking web application that stores notes in the user's own git repository. It is a React (TypeScript) frontend that authenticates with GitHub and works with a companion REST API backend.

## Use cases
- take markdown notes in a self-hosted webapp
- store notes in my own git repository
- edit markdown notes with live preview
- organize notes into nested folders
- log in with GitHub and manage notes
- self-host a note-taking app with dark mode

## When to choose
- you want notes version-controlled in your own GitHub repo
- you prefer markdown with editor preview and folder organization
- you want a self-hosted, container-ready note app with GitHub login

## When to avoid
- you need offline-first or mobile-native note apps
- you don't use GitHub or git for storage
- you need rich-text/WYSIWYG editing or real-time collaboration
- you need an actively developed project with recent releases

## Facets
- artifact type: application
- maturity: maintenance
- function: markdown, editor, self-hosted
- domain: developer-tools, web-development, files
- platform: self-hosted
- tags: note-taking, git-backed, react, github-integration, markdown-editor, web-server, nodejs, docker

## Member repositories
- batnoter/batnoter (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:50.510478+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:33:04.764207+00:00, confidence not recorded.
  - readme: https://github.com/batnoter/batnoter (fetched 2026-08-28T04:06:50.510478+00:00, sha 8bf07ae3134b)
- Data as of 2026-08-30T08:39:29.467469+00:00.