# hackmdio/codimd

CodiMD - Realtime collaborative markdown notes on all platforms.

Repository: https://github.com/hackmdio/codimd
Canonical: https://ross.abutalabs.com/products/codimd
Homepage: https://hackmd.io/c/codimd-documentation
Language: JavaScript
License: AGPL-3.0
License Family: copyleft
Topics: hackmd, collaboration, realtime, notes, markdown, codimd
Last push: 2025-10-02T02:51:07+00:00

## Health v2 (maintenance only)
Score: 49/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 45, release rhythm 26, longevity 100
- inputs: {"age_days": 4139, "days_push": 335, "days_rel": 336, "gap_med": 111, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 10135, forks 1123 (observed 2026-08-28T04:10:39.625062+00:00)

## What it is
CodiMD is a self-hosted, open-source web application for real-time collaborative markdown note editing, built from the HackMD source code. It supports slide and presentation modes, multiple authentication providers (OAuth, SAML, LDAP), and Docker or Kubernetes deployment.

## Use cases
- host a self-hosted collaborative markdown editor for my team
- take shared meeting notes in real time in the browser
- self-host an alternative to HackMD or Notion for docs
- write markdown documents collaboratively with live editing
- create slide presentations from markdown
- own my team's documentation data on my own server

## When to choose
- you want a free, self-hosted HackMD alternative where you control all data
- your team or community needs realtime collaborative markdown notes
- you need SSO via OAuth, SAML, or LDAP for a docs platform
- you want markdown-based slides or book-style docs

## When to avoid
- you need commercial features like book mode and fine-grained permission controls that only HackMD offers
- you need a lightweight single-user markdown editor without a server
- you cannot run a Node.js service or Docker container

## Facets
- artifact type: application
- maturity: active
- function: http-server, websocket, markdown, auth, self-hosted
- domain: web-development, documentation, developer-tools, self-hosted, real-time
- platform: self-hosted, cross-platform
- tags: collaborative-editor, markdown-notes, realtime, note-taking, hackmd, team-documentation, nodejs, web-server, docker

## Member repositories
- hackmdio/codimd (main) score 49

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:39.625062+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-29T17:19:42.292038+00:00, confidence not recorded.
  - readme: https://github.com/hackmdio/codimd (fetched 2026-08-28T04:10:39.625062+00:00, sha 5fcd4d0c4def)
  - homepage: https://hackmd.io/c/codimd-documentation (fetched 2026-08-29T08:19:42.665707+00:00, sha 485c9c42a906)
- Data as of 2026-08-30T08:39:29.467469+00:00.