# @thi.ng/transclude > Extensible functional template engine for text document generation, incl. various high-level Markdown features Latest version **1.1.70** (published 2026-09-01) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @thi.ng/transclude pnpm add @thi.ng/transclude yarn add @thi.ng/transclude bun add @thi.ng/transclude ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 1.1.70 | | Published | 2026-09-01 | | First published | 2022-12-16 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM | | Node | >=18 | | Dependencies | 7 | | Unpacked size | 34.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | Karsten Schmidt | | Maintainers | thi.ng | | Keywords | functional, generator, json, markdown, no-browser, nodejs, npm, parser, template, text, tool, transclusion, typescript | ## Links - npm: https://www.npmjs.com/package/@thi.ng/transclude - Repository: https://codeberg.org/thi.ng/umbrella - Homepage: https://thi.ng/transclude - Funding: https://github.com/sponsors/postspectacular - npm.io page: https://npm.io/package/@thi.ng/transclude ## Dependencies (7) - [@thi.ng/api](https://npm.io/package/@thi.ng/api.md) ^8.12.28 - [@thi.ng/checks](https://npm.io/package/@thi.ng/checks.md) ^3.11.1 - [@thi.ng/errors](https://npm.io/package/@thi.ng/errors.md) ^2.6.17 - [@thi.ng/logger](https://npm.io/package/@thi.ng/logger.md) ^3.3.11 - [@thi.ng/file-io](https://npm.io/package/@thi.ng/file-io.md) ^2.3.3 - [@thi.ng/strings](https://npm.io/package/@thi.ng/strings.md) ^3.12.10 - [@thi.ng/transducers](https://npm.io/package/@thi.ng/transducers.md) ^9.7.0 ## Alternatives - [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads - [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads - [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads - [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads - [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads ## Recent versions - 1.1.70 (latest) — 2026-09-01 - 1.1.69 — 2026-08-25 - 1.1.68 — 2026-07-21 - 1.1.67 — 2026-07-02 - 1.1.66 — 2026-06-05 - 1.1.65 — 2026-05-23 - 1.1.64 — 2026-05-20 - 1.1.62 — 2026-05-11 - 1.1.61 — 2026-05-08 - 1.1.59 — 2026-04-26 - 1.1.58 — 2026-04-18 - 1.1.57 — 2026-04-09 - 1.1.56 — 2026-04-02 - 1.1.55 — 2026-03-21 - 1.1.54 — 2026-03-19 - … 167 more at https://npm.io/package/@thi.ng/transclude/versions ## README # ![@thi.ng/transclude](https://codeberg.org/thi.ng/umbrella/media/branch/develop/assets/banners/thing-transclude.svg?652d2a29) [![npm version](https://img.shields.io/npm/v/@thi.ng/transclude.svg)](https://www.npmjs.com/package/@thi.ng/transclude) ![npm downloads](https://img.shields.io/npm/dm/@thi.ng/transclude.svg) [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi) > [!NOTE] > This is one of 217 standalone projects. LLM-free, human-made and > cared for software, maintained as part of the > [@thi.ng/umbrella](https://codeberg.org/thi.ng/umbrella/) ecosystem and > anti-framework. > > 🚀 Please help me to work full-time on these projects by [sponsoring > me](https://codeberg.org/thi.ng/umbrella/src/branch/develop/CONTRIBUTING.md#donations). > Thank you! ❤️ - [About](#about) - [Status](#status) - [Related packages](#related-packages) - [Installation](#installation) - [Dependencies](#dependencies) - [API](#api) - [Authors](#authors) - [License](#license) ## About Extensible functional template engine for text document generation, incl. various high-level Markdown features. This package evolved from this monorepo's readme generator toolchain and currently is mainly used to generate all ~350 readme & changelog files in this repo, but otherwise is **not** bound to this project in any way. Please see [`/tools/src/readme.ts`](https://codeberg.org/thi.ng/umbrella/src/branch/develop/tools/src/readme.ts) for a concrete usage example... ## Status **STABLE** - used in production [Search or submit any issues for this package](https://codeberg.org/thi.ng/umbrella/issues?q=%5Btransclude%5D) ## Related packages - [@thi.ng/hiccup-markdown](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/hiccup-markdown) - Markdown parser & serializer from/to Hiccup format - [@thi.ng/markdown-table](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/markdown-table) - Markdown table formatter/generator with support for column alignments - [@thi.ng/proctext](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/proctext) - Extensible procedural text generation engine with dynamic, mutable state, indirection, randomizable & recursive variable expansions - [@thi.ng/tangle](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/tangle) - Literate programming code block tangling / codegen utility, inspired by org-mode & noweb ## Installation ```bash yarn add @thi.ng/transclude ``` ESM import: ```ts import * as tra from "@thi.ng/transclude"; ``` For Node.js REPL: ```js const tra = await import("@thi.ng/transclude"); ``` Package sizes (brotli'd, pre-treeshake): ESM: 1.96 KB ## Dependencies - [@thi.ng/api](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/api) - [@thi.ng/checks](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/checks) - [@thi.ng/errors](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/errors) - [@thi.ng/file-io](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/file-io) - [@thi.ng/logger](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/logger) - [@thi.ng/strings](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/strings) - [@thi.ng/transducers](https://codeberg.org/thi.ng/umbrella/src/branch/develop/packages/transducers) Note: @thi.ng/api is in _most_ cases a type-only import (not used at runtime) ## API [Generated API docs](https://docs.thi.ng/umbrella/transclude/) TODO ## Authors - [Karsten Schmidt](https://thi.ng) If this project contributes to an academic publication, please cite it as: ```bibtex @misc{thing-transclude, title = "@thi.ng/transclude", author = "Karsten Schmidt", note = "https://thi.ng/transclude", year = 2022 } ``` ## License © 2022 - 2026 Karsten Schmidt // Apache License 2.0 --- _Source: https://npm.io/package/@thi.ng/transclude · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._