# nobiot/org-transclusion

Emacs package to enable transclusion with Org Mode

Repository: https://github.com/nobiot/org-transclusion
Canonical: https://ross.abutalabs.com/products/org-transclusion
Homepage: https://nobiot.github.io/org-transclusion/
Language: Emacs Lisp
License: GPL-3.0
License Family: copyleft
Topics: emacs, transclusion, org-mode, writing, transclude, org-roam
Last push: 2026-04-17T10:03:19+00:00

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

## Adoption (not part of the score)
Stars 1125, forks 51 (observed 2026-08-28T04:03:40.916185+00:00)

## What it is
An Emacs Lisp package that adds transclusion support to Org Mode, letting users insert live copies of text content via file or ID links. Transcluded content stays synchronized with its source and files remain clean, containing only links rather than duplicated text.

## Use cases
- assemble book drafts from scattered org notes via transclusion
- include the same paragraph in multiple org files without copy-paste
- keep a single source of truth for text reused across org buffers
- refresh transcluded sections after editing their source
- combine org-roam notes into a writing project

## When to choose
- you write long-form documents in Emacs Org Mode from a corpus of notes
- you need content duplicated across org files but want links instead of copies
- you use org-roam and want to compose notes into larger documents

## When to avoid
- you don't use Emacs or Org Mode
- you need transclusion in plain Markdown or other editors
- you need real-time multi-editor synchronization rather than manual refresh

## Facets
- artifact type: plugin
- maturity: active
- function: editor, documentation, markdown
- domain: text-editors, developer-tools, documentation
- platform: editor-plugin, cross-platform
- tags: emacs, org-mode, transclusion, org-roam, emacs-lisp, writing, desktop

## Member repositories
- nobiot/org-transclusion (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:40.916185+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-30T06:39:34.613584+00:00, confidence not recorded.
  - homepage: https://nobiot.github.io/org-transclusion/ (fetched 2026-08-29T12:43:52.948076+00:00, sha cca8539283e0)
- Data as of 2026-08-30T08:39:29.467469+00:00.