mdorigin 0.1.2 → 0.1.3

package/README.md

@@ -2,7 +2,28 @@
 
 `mdorigin` is a markdown-first publishing engine.
 
-It treats markdown as the only source of truth, serves raw `.md` directly for agents, renders `.html` views for humans from the same directory tree, can return markdown from extensionless routes when clients send `Accept: text/markdown`, supports frontmatter aliases for old URL redirects, and can publish skill-style bundles built around `SKILL.md`.
+It treats markdown as the only source of truth, serves raw `.md` directly for agents, renders HTML for humans from the same directory tree, and can expose the same content to both browsers and tools through stable routes.
+
+## Core Principle
+
+`mdorigin` is not meant to become a template system.
+
+Its core is:
+
+- routing rules
+- markdown tree normalization
+- document, index, asset, search, and site semantics
+- stable page models derived from the same content tree
+
+That means `mdorigin` should own content semantics, while page rendering remains extensible. In practice, this is the direction for advanced customization: users should be able to replace page-level rendering with code, without replacing the routing and content kernel itself.
+
+## Why mdorigin
+
+- markdown stays directly accessible at `.md` routes
+- extensionless routes render human-friendly HTML from the same files
+- `README.md`, `index.md`, and `SKILL.md` all fit into one routing model
+- the same core works in local preview and Cloudflare Workers
+- optional search is powered by [`indexbind`](https://github.com/jolestar/indexbind)
 
 ## Install
 
@@ -18,9 +39,53 @@ mdorigin dev --root docs/site
 
 If you prefer a project-local install instead, use `npm install --save-dev mdorigin` and run it with `npx --no-install mdorigin ...`.
 
+## Quick Start
+
+```bash
+mdorigin dev --root docs/site
+mdorigin build index --root docs/site
+mdorigin build cloudflare --root docs/site
+```
+
+That is enough to preview a site locally, keep directory indexes up to date, and generate a Cloudflare Worker bundle.
+
+## Code-Based Extensions
+
+`mdorigin` now supports a code config alongside `mdorigin.config.json`.
+
+Use `mdorigin.config.ts` when you want to customize rendering or indexing with code instead of asking for a template system:
+
+```ts
+export default {
+  siteTitle: "My Site",
+  plugins: [
+    {
+      name: "custom-footer",
+      renderFooter() {
+        return '<footer class="custom-footer">Built with mdorigin</footer>';
+      },
+    },
+  ],
+};
+```
+
+Current stable hooks are:
+
+- `transformIndex(entries, context)`
+- `renderHeader(context)`
+- `renderFooter(context)`
+- `renderPage(page, context, next)`
+- `transformHtml(html, context)`
+
+The intended boundary is:
+
+- `mdorigin` owns routing and normalized content semantics
+- plugins may replace page rendering
+- plugins do not replace the request kernel itself
+
 ## Optional Search
 
-`mdorigin` can build a local retrieval bundle through the optional [`indexbind`](https://github.com/jolestar/indexbind) package:
+`mdorigin` can build a local retrieval bundle through the optional [`indexbind`](https://github.com/jolestar/indexbind) package. For the retrieval engine itself, see the `indexbind` docs: <https://indexbind.jolestar.workers.dev>.
 
 ```bash
 npm install indexbind
@@ -46,33 +111,13 @@ Runtime endpoints:
 - `/api/search?q=cloudflare+deploy`
 - `/api/openapi.json`
 
-## Repo Development
-
-```bash
-npm install
-npm run check
-npm run dev -- --root docs/site
-npm run build:index -- --root docs/site
-```
-
-## Release
-
-Publishing is handled by GitHub Actions through npm trusted publishing.
-
-- workflow: `.github/workflows/release.yml`
-- trigger: push a tag like `v0.1.2`, or run the workflow manually
-
-The npm package settings still need a one-time trusted publisher entry for:
-
-- owner: `jolestar`
-- repository: `mdorigin`
-- workflow file: `release.yml`
-
 ## Docs
 
+- Docs site: <https://mdorigin.jolestar.workers.dev>
 - Getting started: [`docs/site/guides/getting-started.md`](docs/site/guides/getting-started.md)
 - Routing model: [`docs/site/concepts/routing.md`](docs/site/concepts/routing.md)
 - Directory indexes: [`docs/site/concepts/directory-indexes.md`](docs/site/concepts/directory-indexes.md)
 - Configuration: [`docs/site/reference/configuration.md`](docs/site/reference/configuration.md)
 - CLI: [`docs/site/reference/cli.md`](docs/site/reference/cli.md)
+- Search setup: [`docs/site/guides/getting-started.md`](docs/site/guides/getting-started.md#quick-start)
 - Cloudflare deployment: [`docs/site/guides/cloudflare.md`](docs/site/guides/cloudflare.md)

package/dist/adapters/cloudflare.d.ts

@@ -1,4 +1,5 @@
 import { type ContentEntryKind } from '../core/content-store.js';
+import type { MdoPlugin } from '../core/extensions.js';
 import type { ResolvedSiteConfig } from '../core/site-config.js';
 import { type SearchBundleEntry } from '../search.js';
 export interface CloudflareManifestEntry {
@@ -16,4 +17,7 @@ export interface CloudflareManifest {
 export interface ExportedHandlerLike {
     fetch(request: Request): Promise<Response>;
 }
-export declare function createCloudflareWorker(manifest: CloudflareManifest): ExportedHandlerLike;
+export interface CreateCloudflareWorkerOptions {
+    plugins?: MdoPlugin[];
+}
+export declare function createCloudflareWorker(manifest: CloudflareManifest, options?: CreateCloudflareWorkerOptions): ExportedHandlerLike;

package/dist/adapters/cloudflare.js

@@ -1,7 +1,7 @@
 import { MemoryContentStore, } from '../core/content-store.js';
 import { handleSiteRequest } from '../core/request-handler.js';
 import { createSearchApiFromBundle } from '../search.js';
-export function createCloudflareWorker(manifest) {
+export function createCloudflareWorker(manifest, options = {}) {
     const store = new MemoryContentStore(manifest.entries.map((entry) => {
         if (entry.kind === 'text') {
             return {
@@ -50,6 +50,7 @@ export function createCloudflareWorker(manifest) {
                 searchParams: url.searchParams,
                 requestUrl: request.url,
                 searchApi,
+                plugins: options.plugins,
             });
             const headers = new Headers(siteResponse.headers);
             const body = siteResponse.body instanceof Uint8Array

package/dist/adapters/node.d.ts

@@ -1,5 +1,6 @@
 import { type IncomingMessage, type ServerResponse } from 'node:http';
 import type { ContentStore } from '../core/content-store.js';
+import type { MdoPlugin } from '../core/extensions.js';
 import type { ResolvedSiteConfig } from '../core/site-config.js';
 import type { SearchApi } from '../search.js';
 export interface NodeAdapterOptions {
@@ -7,6 +8,7 @@ export interface NodeAdapterOptions {
     draftMode: 'include' | 'exclude';
     siteConfig: ResolvedSiteConfig;
     searchApi?: SearchApi;
+    plugins?: MdoPlugin[];
 }
 export declare function createFileSystemContentStore(rootDir: string): ContentStore;
 export declare function createNodeRequestListener(options: NodeAdapterOptions): (request: IncomingMessage, response: ServerResponse) => Promise<void>;

package/dist/adapters/node.js

@@ -126,6 +126,7 @@ export function createNodeRequestListener(options) {
                 searchParams: url.searchParams,
                 requestUrl: url.toString(),
                 searchApi: options.searchApi,
+                plugins: options.plugins,
             });
             response.statusCode = siteResponse.status;
             for (const [headerName, headerValue] of Object.entries(siteResponse.headers)) {

package/dist/cli/build-cloudflare.js

@@ -1,27 +1,28 @@
 import path from 'node:path';
 import { createFileSystemContentStore } from '../adapters/node.js';
 import { writeCloudflareBundle } from '../cloudflare.js';
-import { applySiteConfigFrontmatterDefaults, loadSiteConfig, } from '../core/site-config.js';
+import { applySiteConfigFrontmatterDefaults, loadUserSiteConfig, } from '../core/site-config.js';
 export async function runBuildCloudflareCommand(argv) {
     const args = parseArgs(argv);
     if (!args.root) {
-        console.error('Usage: mdorigin build cloudflare --root <content-dir> [--out ./dist/cloudflare] [--config mdorigin.config.json] [--search ./dist/search]');
+        console.error('Usage: mdorigin build cloudflare --root <content-dir> [--out ./dist/cloudflare] [--config <config-file>] [--search ./dist/search]');
         process.exitCode = 1;
         return;
     }
     const rootDir = path.resolve(args.root);
-    const loadedSiteConfig = await loadSiteConfig({
+    const loadedConfig = await loadUserSiteConfig({
         cwd: process.cwd(),
         rootDir,
         configPath: args.config,
     });
     const store = createFileSystemContentStore(rootDir);
-    const siteConfig = await applySiteConfigFrontmatterDefaults(store, loadedSiteConfig);
+    const siteConfig = await applySiteConfigFrontmatterDefaults(store, loadedConfig.siteConfig);
     const result = await writeCloudflareBundle({
         rootDir,
         outDir: path.resolve(args.out ?? 'dist/cloudflare'),
         siteConfig,
         searchDir: args.search ? path.resolve(args.search) : undefined,
+        configModulePath: loadedConfig.configModulePath,
     });
     console.log(`cloudflare worker written to ${result.workerFile}`);
 }

package/dist/cli/build-index.js

@@ -1,15 +1,24 @@
 import path from 'node:path';
 import { buildDirectoryIndexes } from '../index-builder.js';
+import { loadUserSiteConfig } from '../core/site-config.js';
 export async function runBuildIndexCommand(argv) {
     const args = parseArgs(argv);
     if (!args.root && !args.dir) {
-        console.error('Usage: mdorigin build index (--root <content-dir> | --dir <content-dir>)');
+        console.error('Usage: mdorigin build index (--root <content-dir> | --dir <content-dir>) [--config <config-file>]');
         process.exitCode = 1;
         return;
     }
+    const rootDir = args.root ? path.resolve(args.root) : undefined;
+    const dir = args.dir ? path.resolve(args.dir) : undefined;
+    const loadedConfig = await loadUserSiteConfig({
+        cwd: process.cwd(),
+        rootDir: rootDir ?? dir,
+        configPath: args.config,
+    });
     const result = await buildDirectoryIndexes({
-        rootDir: args.root ? path.resolve(args.root) : undefined,
-        dir: args.dir ? path.resolve(args.dir) : undefined,
+        rootDir,
+        dir,
+        plugins: loadedConfig.plugins,
     });
     console.log(`updated ${result.updatedFiles.length} index file(s)`);
     if (result.skippedDirectories.length > 0) {
@@ -29,6 +38,11 @@ function parseArgs(argv) {
         if (argument === '--dir' && nextValue) {
             result.dir = nextValue;
             index += 1;
+            continue;
+        }
+        if (argument === '--config' && nextValue) {
+            result.config = nextValue;
+            index += 1;
         }
     }
     return result;

package/dist/cli/build-search.js

@@ -1,18 +1,19 @@
 import path from 'node:path';
 import { buildSearchBundle } from '../search.js';
-import { applySiteConfigFrontmatterDefaults, loadSiteConfig } from '../core/site-config.js';
+import { applySiteConfigFrontmatterDefaults, loadUserSiteConfig, } from '../core/site-config.js';
 import { createFileSystemContentStore } from '../adapters/node.js';
 export async function runBuildSearchCommand(rawArgs) {
     const args = parseArgs(rawArgs);
     if (!args.root) {
-        throw new Error('Usage: mdorigin build search --root <content-dir> [--out ./dist/search] [--embedding-backend model2vec|hashing] [--model sentence-transformers/all-MiniLM-L6-v2] [--config mdorigin.config.json]');
+        throw new Error('Usage: mdorigin build search --root <content-dir> [--out ./dist/search] [--embedding-backend model2vec|hashing] [--model sentence-transformers/all-MiniLM-L6-v2] [--config <config-file>]');
     }
     const rootDir = path.resolve(args.root);
     const store = createFileSystemContentStore(rootDir);
-    const siteConfig = await applySiteConfigFrontmatterDefaults(store, await loadSiteConfig({
+    const loadedConfig = await loadUserSiteConfig({
         rootDir,
         configPath: args.config,
-    }));
+    });
+    const siteConfig = await applySiteConfigFrontmatterDefaults(store, loadedConfig.siteConfig);
     const result = await buildSearchBundle({
         rootDir,
         outDir: path.resolve(args.out ?? 'dist/search'),

package/dist/cli/dev.js

@@ -1,23 +1,23 @@
 import path from 'node:path';
 import { createFileSystemContentStore, createNodeServer } from '../adapters/node.js';
-import { applySiteConfigFrontmatterDefaults, loadSiteConfig, } from '../core/site-config.js';
+import { applySiteConfigFrontmatterDefaults, loadUserSiteConfig, } from '../core/site-config.js';
 import { createSearchApiFromDirectory } from '../search.js';
 export async function runDevCommand(argv) {
     const args = parseArgs(argv);
     if (!args.root) {
-        console.error('Usage: mdorigin dev --root <content-dir> [--port 3000] [--config mdorigin.config.json] [--search ./dist/search]');
+        console.error('Usage: mdorigin dev --root <content-dir> [--port 3000] [--config <config-file>] [--search ./dist/search]');
         process.exitCode = 1;
         return;
     }
     const rootDir = path.resolve(args.root);
     const port = args.port ?? 3000;
-    const loadedSiteConfig = await loadSiteConfig({
+    const loadedConfig = await loadUserSiteConfig({
         cwd: process.cwd(),
         rootDir,
         configPath: args.config,
     });
     const store = createFileSystemContentStore(rootDir);
-    const siteConfig = await applySiteConfigFrontmatterDefaults(store, loadedSiteConfig);
+    const siteConfig = await applySiteConfigFrontmatterDefaults(store, loadedConfig.siteConfig);
     const server = createNodeServer({
         rootDir,
         draftMode: 'include',
@@ -25,6 +25,7 @@ export async function runDevCommand(argv) {
         searchApi: args.search
             ? await createSearchApiFromDirectory(path.resolve(args.search))
             : undefined,
+        plugins: loadedConfig.plugins,
     });
     await new Promise((resolve, reject) => {
         server.once('error', reject);

package/dist/cli/main.js

@@ -33,10 +33,10 @@ async function main() {
     }
     console.error([
         'Usage:',
-        '  mdorigin dev --root <content-dir> [--port 3000] [--config mdorigin.config.json] [--search ./dist/search]',
-        '  mdorigin build index (--root <content-dir> | --dir <content-dir>)',
-        '  mdorigin build search --root <content-dir> [--out ./dist/search] [--embedding-backend model2vec|hashing] [--model sentence-transformers/all-MiniLM-L6-v2] [--config mdorigin.config.json]',
-        '  mdorigin build cloudflare --root <content-dir> [--out ./dist/cloudflare] [--config mdorigin.config.json] [--search ./dist/search]',
+        '  mdorigin dev --root <content-dir> [--port 3000] [--config <config-file>] [--search ./dist/search]',
+        '  mdorigin build index (--root <content-dir> | --dir <content-dir>) [--config <config-file>]',
+        '  mdorigin build search --root <content-dir> [--out ./dist/search] [--embedding-backend model2vec|hashing] [--model sentence-transformers/all-MiniLM-L6-v2] [--config <config-file>]',
+        '  mdorigin build cloudflare --root <content-dir> [--out ./dist/cloudflare] [--config <config-file>] [--search ./dist/search]',
         '  mdorigin init cloudflare [--dir .] [--entry ./dist/cloudflare/worker.mjs] [--name <worker-name>] [--compatibility-date 2026-03-20] [--force]',
         '  mdorigin search --index <search-dir> [--top-k 10] <query>',
     ].join('\n'));

package/dist/cloudflare.d.ts

@@ -14,6 +14,7 @@ export interface WriteCloudflareBundleOptions {
     siteConfig: ResolvedSiteConfig;
     packageImport?: string;
     searchDir?: string;
+    configModulePath?: string;
 }
 export interface InitCloudflareProjectOptions {
     projectDir: string;

package/dist/cloudflare.js

@@ -49,12 +49,37 @@ export async function writeCloudflareBundle(options) {
     });
     const packageImport = options.packageImport ?? 'mdorigin/cloudflare-runtime';
     const workerFile = path.join(outDir, 'worker.mjs');
+    const configImportPath = options.configModulePath
+        ? toPosixPath(path.relative(outDir, options.configModulePath))
+        : null;
     const workerSource = [
         `import { createCloudflareWorker } from '${packageImport}';`,
+        configImportPath
+            ? `import * as userConfigModule from '${configImportPath.startsWith('.') ? configImportPath : `./${configImportPath}`}';`
+            : '',
         '',
         `const manifest = ${JSON.stringify(manifest, null, 2)};`,
         '',
-        'export default createCloudflareWorker(manifest);',
+        configImportPath
+            ? [
+                'function unwrapUserConfigModule(moduleValue) {',
+                '  let current = moduleValue;',
+                "  while (current && typeof current === 'object' && 'default' in current && current.default !== undefined) {",
+                '    current = current.default;',
+                '  }',
+                "  if (current && typeof current === 'object' && 'config' in current && current.config !== undefined) {",
+                '    return current.config;',
+                '  }',
+                '  return current;',
+                '}',
+                '',
+                'const userConfig = unwrapUserConfigModule(userConfigModule);',
+                '',
+            ].join('\n')
+            : '',
+        configImportPath
+            ? 'export default createCloudflareWorker(manifest, { plugins: Array.isArray(userConfig?.plugins) ? userConfig.plugins : [] });'
+            : 'export default createCloudflareWorker(manifest);',
         '',
     ].join('\n');
     await mkdir(outDir, { recursive: true });

package/dist/core/extensions.d.ts

@@ -0,0 +1,66 @@
+import type { ManagedIndexEntry } from './markdown.js';
+import type { EditLinkConfig, ResolvedSiteConfig, SiteLogo, SiteNavItem, SiteSocialLink } from './site-config.js';
+import type { TemplateName } from '../html/template-kind.js';
+import type { BuiltInThemeName } from '../html/theme.js';
+type MaybePromise<T> = T | Promise<T>;
+export interface IndexTransformContext {
+    mode: 'build' | 'render';
+    directoryPath?: string;
+    requestPath?: string;
+    sourcePath?: string;
+    siteConfig?: ResolvedSiteConfig;
+}
+export interface PageRenderModel {
+    kind: 'document' | 'catalog';
+    requestPath: string;
+    sourcePath: string;
+    siteTitle: string;
+    siteDescription?: string;
+    siteUrl?: string;
+    favicon?: string;
+    socialImage?: string;
+    logo?: SiteLogo;
+    title: string;
+    bodyHtml: string;
+    summary?: string;
+    date?: string;
+    showSummary: boolean;
+    showDate: boolean;
+    theme: BuiltInThemeName;
+    template: TemplateName;
+    topNav: SiteNavItem[];
+    footerNav: SiteNavItem[];
+    footerText?: string;
+    socialLinks: SiteSocialLink[];
+    editLink?: EditLinkConfig;
+    editLinkHref?: string;
+    stylesheetContent?: string;
+    canonicalPath?: string;
+    alternateMarkdownPath?: string;
+    catalogEntries: ManagedIndexEntry[];
+    catalogRequestPath: string;
+    catalogInitialPostCount: number;
+    catalogLoadMoreStep: number;
+    searchEnabled: boolean;
+}
+export interface RenderHookContext {
+    page: PageRenderModel;
+    siteConfig: ResolvedSiteConfig;
+}
+export interface MdoPlugin {
+    name?: string;
+    transformIndex?(entries: ManagedIndexEntry[], context: IndexTransformContext): MaybePromise<ManagedIndexEntry[]>;
+    renderHeader?(context: RenderHookContext): MaybePromise<string | undefined | null>;
+    renderFooter?(context: RenderHookContext): MaybePromise<string | undefined | null>;
+    renderPage?(page: PageRenderModel, context: RenderHookContext, next: (page: PageRenderModel) => MaybePromise<string>): MaybePromise<string | undefined | null>;
+    transformHtml?(html: string, context: RenderHookContext): MaybePromise<string>;
+}
+export declare function applyIndexTransforms(entries: ManagedIndexEntry[], plugins: MdoPlugin[], context: IndexTransformContext): Promise<ManagedIndexEntry[]>;
+export declare function renderHeaderOverride(plugins: MdoPlugin[], context: RenderHookContext): Promise<string | undefined>;
+export declare function renderFooterOverride(plugins: MdoPlugin[], context: RenderHookContext): Promise<string | undefined>;
+export declare function renderPageWithPlugins(page: PageRenderModel, plugins: MdoPlugin[], context: RenderHookContext, renderDefault: (page: PageRenderModel) => MaybePromise<string>): Promise<{
+    html: string;
+    page: PageRenderModel;
+}>;
+export declare function transformHtmlWithPlugins(html: string, plugins: MdoPlugin[], context: RenderHookContext): Promise<string>;
+export {};

package/dist/core/extensions.js

@@ -0,0 +1,86 @@
+export async function applyIndexTransforms(entries, plugins, context) {
+    let current = [...entries];
+    for (const plugin of plugins) {
+        if (!plugin.transformIndex) {
+            continue;
+        }
+        current = [...(await plugin.transformIndex(current, context))];
+    }
+    return current;
+}
+export async function renderHeaderOverride(plugins, context) {
+    let rendered;
+    for (const plugin of plugins) {
+        if (!plugin.renderHeader) {
+            continue;
+        }
+        const value = await plugin.renderHeader(context);
+        if (typeof value === 'string') {
+            rendered = value;
+        }
+    }
+    return rendered;
+}
+export async function renderFooterOverride(plugins, context) {
+    let rendered;
+    for (const plugin of plugins) {
+        if (!plugin.renderFooter) {
+            continue;
+        }
+        const value = await plugin.renderFooter(context);
+        if (typeof value === 'string') {
+            rendered = value;
+        }
+    }
+    return rendered;
+}
+export async function renderPageWithPlugins(page, plugins, context, renderDefault) {
+    const renderers = plugins
+        .map((plugin) => plugin.renderPage)
+        .filter((renderPage) => typeof renderPage === 'function');
+    let finalPage = page;
+    const dispatch = async (index, currentPage) => {
+        const renderPage = renderers[index];
+        if (!renderPage) {
+            finalPage = currentPage;
+            return renderDefault(currentPage);
+        }
+        const currentContext = {
+            ...context,
+            page: currentPage,
+        };
+        let nextInvoked = false;
+        const next = async (nextPage) => {
+            nextInvoked = true;
+            finalPage = nextPage;
+            return dispatch(index + 1, nextPage);
+        };
+        const rendered = await renderPage(currentPage, currentContext, next);
+        if (typeof rendered === 'string') {
+            if (!nextInvoked) {
+                finalPage = currentPage;
+            }
+            return rendered;
+        }
+        return next(currentPage);
+    };
+    return {
+        html: await dispatch(0, page),
+        page: finalPage,
+    };
+}
+export async function transformHtmlWithPlugins(html, plugins, context) {
+    let current = html;
+    for (const plugin of plugins) {
+        if (!plugin.transformHtml) {
+            continue;
+        }
+        const result = await plugin.transformHtml(current, context);
+        if (typeof result !== 'string') {
+            const pluginName = plugin.name ?? 'unknown plugin';
+            throw new Error(`transformHtmlWithPlugins expected plugin "${pluginName}" to return a string, but got ${typeof result}`);
+        }
+        current = result;
+    }
+    return current;
+}

package/dist/core/request-handler.d.ts

@@ -1,4 +1,5 @@
 import type { ContentStore } from './content-store.js';
+import type { MdoPlugin } from './extensions.js';
 import type { ResolvedSiteConfig } from './site-config.js';
 import type { SearchApi } from '../search.js';
 export interface HandleSiteRequestOptions {
@@ -8,6 +9,7 @@ export interface HandleSiteRequestOptions {
     searchParams?: URLSearchParams;
     requestUrl?: string;
     searchApi?: SearchApi;
+    plugins?: MdoPlugin[];
 }
 export interface SiteResponse {
     status: number;

package/dist/core/request-handler.js

@@ -2,10 +2,12 @@ import path from 'node:path';
 import { inferDirectoryContentType } from './content-type.js';
 import { getDirectoryIndexCandidates } from './directory-index.js';
 import { extractManagedIndexEntries, getDocumentSummary, getDocumentTitle as getParsedDocumentTitle, parseMarkdownDocument, stripManagedIndexBlock, stripManagedIndexLinks, } from './markdown.js';
+import { applyIndexTransforms, renderFooterOverride, renderHeaderOverride, renderPageWithPlugins, transformHtmlWithPlugins, } from './extensions.js';
 import { handleApiRoute } from './api.js';
 import { normalizeRequestPath, resolveRequest } from './router.js';
 import { escapeHtml, renderCatalogArticleItems, renderDocument, } from '../html/template.js';
 export async function handleSiteRequest(store, pathname, options) {
+    const plugins = options.plugins ?? [];
     const searchEnabled = options.searchApi !== undefined;
     const apiRoute = await handleApiRoute(pathname, options.searchParams, {
         searchApi: options.searchApi,
@@ -81,7 +83,12 @@ export async function handleSiteRequest(store, pathname, options) {
             ? stripManagedIndexLinks(entry.text, new Set(navigation.items.map((item) => item.href)))
             : entry.text;
     const catalogEntries = options.siteConfig.template === 'catalog'
-        ? extractManagedIndexEntries(renderedBody)
+        ? await applyIndexTransforms(extractManagedIndexEntries(renderedBody), plugins, {
+            mode: 'render',
+            requestPath: resolved.requestPath,
+            sourcePath: resolved.sourcePath,
+            siteConfig: options.siteConfig,
+        })
         : [];
     if (catalogFragmentRequest !== null &&
         options.siteConfig.template === 'catalog') {
@@ -93,42 +100,18 @@ export async function handleSiteRequest(store, pathname, options) {
     const renderedParsed = documentBody === entry.text
         ? parsed
         : await parseMarkdownDocument(resolved.sourcePath, documentBody);
-    return {
-        status: 200,
-        headers: withVaryAcceptIfNeeded({
-            'content-type': 'text/html; charset=utf-8',
-        }, shouldVaryOnAccept(resolved)),
-        body: renderDocument({
-            siteTitle: options.siteConfig.siteTitle,
-            siteDescription: options.siteConfig.siteDescription,
-            siteUrl: options.siteConfig.siteUrl,
-            favicon: options.siteConfig.favicon,
-            logo: options.siteConfig.logo,
-            title: getDocumentTitle(parsed),
-            body: renderedParsed.html,
-            summary: options.siteConfig.showSummary === false
-                ? undefined
-                : getDocumentSummary(parsed.meta, parsed.body),
-            date: options.siteConfig.showDate === false ? undefined : parsed.meta.date,
-            showSummary: options.siteConfig.showSummary,
-            showDate: options.siteConfig.showDate,
-            theme: options.siteConfig.theme,
-            template: options.siteConfig.template,
-            topNav: navigation.items,
-            footerNav: options.siteConfig.footerNav,
-            footerText: options.siteConfig.footerText,
-            socialLinks: options.siteConfig.socialLinks,
-            editLinkHref: getEditLinkHref(options.siteConfig, resolved.sourcePath),
-            stylesheetContent: options.siteConfig.stylesheetContent,
-            canonicalPath: getCanonicalHtmlPathForContentPath(resolved.sourcePath),
-            alternateMarkdownPath: getMarkdownRequestPathForContentPath(resolved.sourcePath),
-            catalogEntries,
-            catalogRequestPath: resolved.requestPath,
-            catalogInitialPostCount: options.siteConfig.catalogInitialPostCount,
-            catalogLoadMoreStep: options.siteConfig.catalogLoadMoreStep,
-            searchEnabled,
-        }),
-    };
+    return renderStructuredPage({
+        requestPath: resolved.requestPath,
+        sourcePath: resolved.sourcePath,
+        parsed,
+        renderedParsed,
+        siteConfig: options.siteConfig,
+        topNav: navigation.items,
+        catalogEntries,
+        searchEnabled,
+        plugins,
+        varyOnAccept: shouldVaryOnAccept(resolved),
+    });
 }
 function getCatalogFragmentRequest(searchParams) {
     if (searchParams?.get('catalog-format') !== 'posts') {
@@ -155,6 +138,109 @@ function normalizePositiveInteger(value) {
     const parsed = Number.parseInt(value, 10);
     return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
 }
+function buildPageRenderModel(options) {
+    return {
+        kind: options.siteConfig.template === 'catalog' ? 'catalog' : 'document',
+        requestPath: options.resolvedRequestPath,
+        sourcePath: options.sourcePath,
+        siteTitle: options.siteConfig.siteTitle,
+        siteDescription: options.siteConfig.siteDescription,
+        siteUrl: options.siteConfig.siteUrl,
+        favicon: options.siteConfig.favicon,
+        socialImage: options.siteConfig.socialImage,
+        logo: options.siteConfig.logo,
+        title: getDocumentTitle(options.parsed),
+        bodyHtml: options.renderedBodyHtml,
+        summary: options.siteConfig.showSummary === false
+            ? undefined
+            : getDocumentSummary(options.parsed.meta, options.parsed.body),
+        date: options.siteConfig.showDate === false ? undefined : options.parsed.meta.date,
+        showSummary: options.siteConfig.showSummary,
+        showDate: options.siteConfig.showDate,
+        theme: options.siteConfig.theme,
+        template: options.siteConfig.template,
+        topNav: options.topNav,
+        footerNav: options.siteConfig.footerNav,
+        footerText: options.siteConfig.footerText,
+        socialLinks: options.siteConfig.socialLinks,
+        editLink: options.siteConfig.editLink,
+        editLinkHref: getEditLinkHref(options.siteConfig, options.sourcePath),
+        stylesheetContent: options.siteConfig.stylesheetContent,
+        canonicalPath: getCanonicalHtmlPathForContentPath(options.sourcePath),
+        alternateMarkdownPath: getMarkdownRequestPathForContentPath(options.sourcePath),
+        catalogEntries: options.catalogEntries,
+        catalogRequestPath: options.resolvedRequestPath,
+        catalogInitialPostCount: options.siteConfig.catalogInitialPostCount,
+        catalogLoadMoreStep: options.siteConfig.catalogLoadMoreStep,
+        searchEnabled: options.searchEnabled,
+    };
+}
+async function renderStructuredPage(options) {
+    const page = buildPageRenderModel({
+        resolvedRequestPath: options.requestPath,
+        sourcePath: options.sourcePath,
+        renderedBodyHtml: options.renderedParsed.html,
+        parsed: options.parsed,
+        siteConfig: options.siteConfig,
+        topNav: options.topNav,
+        catalogEntries: options.catalogEntries,
+        searchEnabled: options.searchEnabled,
+    });
+    const renderContext = {
+        page,
+        siteConfig: options.siteConfig,
+    };
+    const renderedPage = await renderPageWithPlugins(page, options.plugins, renderContext, async (currentPage) => {
+        const currentContext = {
+            page: currentPage,
+            siteConfig: options.siteConfig,
+        };
+        const headerHtml = await renderHeaderOverride(options.plugins, currentContext);
+        const footerHtml = await renderFooterOverride(options.plugins, currentContext);
+        return (renderDocument({
+            siteTitle: currentPage.siteTitle,
+            siteDescription: currentPage.siteDescription,
+            siteUrl: currentPage.siteUrl,
+            favicon: currentPage.favicon,
+            socialImage: currentPage.socialImage,
+            logo: currentPage.logo,
+            title: currentPage.title,
+            body: currentPage.bodyHtml,
+            summary: currentPage.summary,
+            date: currentPage.date,
+            showSummary: currentPage.showSummary,
+            showDate: currentPage.showDate,
+            theme: currentPage.theme,
+            template: currentPage.template,
+            topNav: currentPage.topNav,
+            footerNav: currentPage.footerNav,
+            footerText: currentPage.footerText,
+            socialLinks: currentPage.socialLinks,
+            editLinkHref: currentPage.editLinkHref,
+            stylesheetContent: currentPage.stylesheetContent,
+            canonicalPath: currentPage.canonicalPath,
+            alternateMarkdownPath: currentPage.alternateMarkdownPath,
+            catalogEntries: currentPage.catalogEntries,
+            catalogRequestPath: currentPage.catalogRequestPath,
+            catalogInitialPostCount: currentPage.catalogInitialPostCount,
+            catalogLoadMoreStep: currentPage.catalogLoadMoreStep,
+            searchEnabled: currentPage.searchEnabled,
+            headerHtml,
+            footerHtml,
+        }));
+    });
+    const finalHtml = await transformHtmlWithPlugins(renderedPage.html, options.plugins, {
+        page: renderedPage.page,
+        siteConfig: options.siteConfig,
+    });
+    return {
+        status: 200,
+        headers: withVaryAcceptIfNeeded({
+            'content-type': 'text/html; charset=utf-8',
+        }, options.varyOnAccept ?? false),
+        body: finalHtml,
+    };
+}
 function renderCatalogPostsFragment(entries, request) {
     const articles = entries.filter((entry) => entry.kind === 'article');
     const visibleArticles = articles.slice(request.offset, request.offset + request.limit);
@@ -377,6 +463,7 @@ function getDirectoryIndexContentPathForRequestPath(requestPath) {
         : `${requestPath.slice(1).replace(/\/$/, '')}/index.md`;
 }
 async function tryRenderAlternateDirectoryIndex(store, requestPath, options) {
+    const plugins = options.plugins ?? [];
     const directoryPath = requestPath === '/' ? '' : requestPath.slice(1).replace(/\/$/, '');
     for (const candidatePath of getDirectoryIndexCandidates(directoryPath)) {
         if (candidatePath === (directoryPath === '' ? 'index.md' : `${directoryPath}/index.md`)) {
@@ -397,7 +484,12 @@ async function tryRenderAlternateDirectoryIndex(store, requestPath, options) {
                 ? stripManagedIndexLinks(entry.text, new Set(navigation.items.map((item) => item.href)))
                 : entry.text;
         const catalogEntries = options.siteConfig.template === 'catalog'
-            ? extractManagedIndexEntries(renderedBody)
+            ? await applyIndexTransforms(extractManagedIndexEntries(renderedBody), plugins, {
+                mode: 'render',
+                requestPath,
+                sourcePath: candidatePath,
+                siteConfig: options.siteConfig,
+            })
             : [];
         const catalogFragmentRequest = getCatalogFragmentRequest(options.searchParams);
         if (catalogFragmentRequest !== null &&
@@ -410,42 +502,17 @@ async function tryRenderAlternateDirectoryIndex(store, requestPath, options) {
         const renderedParsed = documentBody === entry.text
             ? parsed
             : await parseMarkdownDocument(candidatePath, documentBody);
-        return {
-            status: 200,
-            headers: {
-                'content-type': 'text/html; charset=utf-8',
-            },
-            body: renderDocument({
-                siteTitle: options.siteConfig.siteTitle,
-                siteDescription: options.siteConfig.siteDescription,
-                siteUrl: options.siteConfig.siteUrl,
-                favicon: options.siteConfig.favicon,
-                logo: options.siteConfig.logo,
-                title: getDocumentTitle(parsed),
-                body: renderedParsed.html,
-                summary: options.siteConfig.showSummary === false
-                    ? undefined
-                    : getDocumentSummary(parsed.meta, parsed.body),
-                date: options.siteConfig.showDate === false ? undefined : parsed.meta.date,
-                showSummary: options.siteConfig.showSummary,
-                showDate: options.siteConfig.showDate,
-                theme: options.siteConfig.theme,
-                template: options.siteConfig.template,
-                topNav: navigation.items,
-                footerNav: options.siteConfig.footerNav,
-                footerText: options.siteConfig.footerText,
-                socialLinks: options.siteConfig.socialLinks,
-                editLinkHref: getEditLinkHref(options.siteConfig, candidatePath),
-                stylesheetContent: options.siteConfig.stylesheetContent,
-                canonicalPath: requestPath,
-                alternateMarkdownPath: getMarkdownRequestPathForContentPath(candidatePath),
-                catalogEntries,
-                catalogRequestPath: requestPath,
-                catalogInitialPostCount: options.siteConfig.catalogInitialPostCount,
-                catalogLoadMoreStep: options.siteConfig.catalogLoadMoreStep,
-                searchEnabled: options.searchApi !== undefined,
-            }),
-        };
+        return renderStructuredPage({
+            requestPath,
+            sourcePath: candidatePath,
+            parsed,
+            renderedParsed,
+            siteConfig: options.siteConfig,
+            topNav: navigation.items,
+            catalogEntries,
+            searchEnabled: options.searchApi !== undefined,
+            plugins,
+        });
     }
     return null;
 }

package/dist/core/site-config.d.ts

@@ -1,4 +1,5 @@
 import type { ContentStore } from './content-store.js';
+import type { MdoPlugin } from './extensions.js';
 import type { TemplateName } from '../html/template-kind.js';
 import type { BuiltInThemeName } from '../html/theme.js';
 export interface SiteNavItem {
@@ -23,6 +24,7 @@ export interface SiteConfig {
     siteDescription?: string;
     siteUrl?: string;
     favicon?: string;
+    socialImage?: string;
     logo?: SiteLogo;
     showDate?: boolean;
     showSummary?: boolean;
@@ -38,11 +40,15 @@ export interface SiteConfig {
     catalogInitialPostCount?: number;
     catalogLoadMoreStep?: number;
 }
+export interface UserSiteConfig extends SiteConfig {
+    plugins?: MdoPlugin[];
+}
 export interface ResolvedSiteConfig {
     siteTitle: string;
     siteDescription?: string;
     siteUrl?: string;
     favicon?: string;
+    socialImage?: string;
     logo?: SiteLogo;
     showDate: boolean;
     showSummary: boolean;
@@ -65,5 +71,13 @@ export interface LoadSiteConfigOptions {
     rootDir?: string;
     configPath?: string;
 }
+export interface LoadedSiteConfig {
+    siteConfig: ResolvedSiteConfig;
+    plugins: MdoPlugin[];
+    configFilePath: string;
+    configModulePath?: string;
+}
 export declare function loadSiteConfig(options?: LoadSiteConfigOptions): Promise<ResolvedSiteConfig>;
+export declare function loadUserSiteConfig(options?: LoadSiteConfigOptions): Promise<LoadedSiteConfig>;
 export declare function applySiteConfigFrontmatterDefaults(store: ContentStore, siteConfig: ResolvedSiteConfig): Promise<ResolvedSiteConfig>;
+export declare function defineConfig(config: UserSiteConfig): UserSiteConfig;

package/dist/core/site-config.js

@@ -1,30 +1,26 @@
-import { readFile } from 'node:fs/promises';
+import { readFile, stat } from 'node:fs/promises';
 import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { tsImport } from 'tsx/esm/api';
 import { getDirectoryIndexCandidates } from './directory-index.js';
 import { parseMarkdownDocument } from './markdown.js';
 export async function loadSiteConfig(options = {}) {
+    return (await loadUserSiteConfig(options)).siteConfig;
+}
+export async function loadUserSiteConfig(options = {}) {
     const cwd = path.resolve(options.cwd ?? process.cwd());
     const rootDir = options.rootDir ? path.resolve(options.rootDir) : null;
     const configFilePath = options.configPath
         ? path.resolve(cwd, options.configPath)
         : await resolveDefaultConfigPath(cwd, rootDir);
-    let parsedConfig = {};
-    try {
-        const configSource = await readFile(configFilePath, 'utf8');
-        parsedConfig = JSON.parse(configSource);
-    }
-    catch (error) {
-        if (!isNodeNotFound(error)) {
-            throw error;
-        }
-    }
+    const parsedConfig = await loadConfigSource(configFilePath);
     const stylesheetPath = parsedConfig.stylesheet
         ? path.resolve(path.dirname(configFilePath), parsedConfig.stylesheet)
         : null;
     const stylesheetContent = stylesheetPath
         ? await readFile(stylesheetPath, 'utf8')
         : undefined;
-    return {
+    const siteConfig = {
         siteTitle: typeof parsedConfig.siteTitle === 'string' && parsedConfig.siteTitle !== ''
             ? parsedConfig.siteTitle
             : 'mdorigin',
@@ -34,6 +30,7 @@ export async function loadSiteConfig(options = {}) {
             : undefined,
         siteUrl: normalizeSiteUrl(parsedConfig.siteUrl),
         favicon: normalizeSiteHref(parsedConfig.favicon),
+        socialImage: normalizeSiteHref(parsedConfig.socialImage),
         logo: normalizeLogo(parsedConfig.logo),
         showDate: parsedConfig.showDate ?? true,
         showSummary: parsedConfig.showSummary ?? true,
@@ -56,6 +53,12 @@ export async function loadSiteConfig(options = {}) {
         siteDescriptionConfigured: typeof parsedConfig.siteDescription === 'string' &&
             parsedConfig.siteDescription !== '',
     };
+    return {
+        siteConfig,
+        plugins: Array.isArray(parsedConfig.plugins) ? parsedConfig.plugins : [],
+        configFilePath,
+        configModulePath: isCodeConfigPath(configFilePath) ? configFilePath : undefined,
+    };
 }
 export async function applySiteConfigFrontmatterDefaults(store, siteConfig) {
     if (siteConfig.siteTitleConfigured && siteConfig.siteDescriptionConfigured) {
@@ -84,11 +87,11 @@ export async function applySiteConfigFrontmatterDefaults(store, siteConfig) {
     return siteConfig;
 }
 async function resolveDefaultConfigPath(cwd, rootDir) {
-    const rootConfigPath = rootDir ? path.join(rootDir, 'mdorigin.config.json') : null;
-    if (rootConfigPath && (await pathExists(rootConfigPath))) {
+    const rootConfigPath = rootDir ? await findConfigPath(rootDir) : null;
+    if (rootConfigPath) {
         return rootConfigPath;
     }
-    return path.join(cwd, 'mdorigin.config.json');
+    return (await findConfigPath(cwd)) ?? path.join(cwd, 'mdorigin.config.json');
 }
 function isBuiltInThemeName(value) {
     return value === 'paper' || value === 'atlas' || value === 'gazette';
@@ -104,7 +107,7 @@ function isNodeNotFound(error) {
 }
 async function pathExists(filePath) {
     try {
-        await readFile(filePath, 'utf8');
+        await stat(filePath);
         return true;
     }
     catch (error) {
@@ -114,6 +117,61 @@ async function pathExists(filePath) {
         throw error;
     }
 }
+async function findConfigPath(directory) {
+    for (const candidate of getConfigCandidates(directory)) {
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function getConfigCandidates(directory) {
+    return [
+        path.join(directory, 'mdorigin.config.ts'),
+        path.join(directory, 'mdorigin.config.mjs'),
+        path.join(directory, 'mdorigin.config.js'),
+        path.join(directory, 'mdorigin.config.json'),
+    ];
+}
+async function loadConfigSource(configFilePath) {
+    if (!(await pathExists(configFilePath))) {
+        return {};
+    }
+    if (configFilePath.endsWith('.json')) {
+        const configSource = await readFile(configFilePath, 'utf8');
+        return JSON.parse(configSource);
+    }
+    const imported = configFilePath.endsWith('.ts')
+        ? await tsImport(configFilePath, import.meta.url)
+        : await import(pathToFileURL(configFilePath).href);
+    const config = unwrapConfigModule(imported);
+    if (typeof config !== 'object' || config === null) {
+        throw new Error(`${configFilePath} must export a config object`);
+    }
+    return config;
+}
+function isCodeConfigPath(filePath) {
+    return /\.(mjs|js|ts)$/.test(filePath);
+}
+export function defineConfig(config) {
+    return config;
+}
+function unwrapConfigModule(moduleValue) {
+    let current = moduleValue;
+    while (typeof current === 'object' &&
+        current !== null &&
+        'default' in current &&
+        current.default !== undefined) {
+        current = current.default;
+    }
+    if (typeof current === 'object' &&
+        current !== null &&
+        'config' in current &&
+        current.config !== undefined) {
+        return current.config;
+    }
+    return current;
+}
 function normalizeTopNav(value) {
     if (!Array.isArray(value)) {
         return [];

package/dist/html/template.d.ts

@@ -7,6 +7,7 @@ export interface RenderDocumentOptions {
     siteDescription?: string;
     siteUrl?: string;
     favicon?: string;
+    socialImage?: string;
     logo?: SiteLogo;
     title: string;
     body: string;
@@ -29,6 +30,8 @@ export interface RenderDocumentOptions {
     catalogInitialPostCount?: number;
     catalogLoadMoreStep?: number;
     searchEnabled?: boolean;
+    headerHtml?: string;
+    footerHtml?: string;
 }
 export declare function renderDocument(options: RenderDocumentOptions): string;
 export declare function escapeHtml(value: string): string;

package/dist/html/template.js

@@ -14,6 +14,14 @@ export function renderDocument(options) {
     const faviconMeta = options.favicon
         ? `<link rel="icon" href="${escapeHtml(options.favicon)}">`
         : '';
+    const absoluteSocialImageUrl = getAbsoluteSiteAssetUrl(options.siteUrl, options.socialImage);
+    const socialImageMeta = absoluteSocialImageUrl
+        ? [
+            `<meta property="og:image" content="${escapeHtml(absoluteSocialImageUrl)}">`,
+            '<meta name="twitter:card" content="summary_large_image">',
+            `<meta name="twitter:image" content="${escapeHtml(absoluteSocialImageUrl)}">`,
+        ].join('')
+        : '';
     const alternateMarkdownMeta = options.alternateMarkdownPath
         ? `<link rel="alternate" type="text/markdown" href="${escapeHtml(options.alternateMarkdownPath)}">`
         : '';
@@ -78,6 +86,9 @@ export function renderDocument(options) {
         })
         : options.body;
     const searchScript = options.searchEnabled ? renderSearchScript() : '';
+    const headerBlock = options.headerHtml ??
+        `<header class="site-header"><div class="site-header__inner"><div class="site-header__brand"><p class="site-header__title"><a href="${brandHref}">${logoBlock}<span>${siteTitle}</span></a></p>${siteDescriptionBlock}</div><div class="site-header__actions">${navBlock}${searchToggleBlock}</div></div></header>`;
+    const renderedFooterBlock = options.footerHtml ?? footerBlock;
     return [
         '<!doctype html>',
         '<html lang="en">',
@@ -88,20 +99,33 @@ export function renderDocument(options) {
         summaryMeta,
         canonicalMeta,
         faviconMeta,
+        socialImageMeta,
         alternateMarkdownMeta,
         stylesheetBlock,
         '</head>',
         `<body data-theme="${options.theme}" data-template="${options.template}">`,
-        `<header class="site-header"><div class="site-header__inner"><div class="site-header__brand"><p class="site-header__title"><a href="${brandHref}">${logoBlock}<span>${siteTitle}</span></a></p>${siteDescriptionBlock}</div><div class="site-header__actions">${navBlock}${searchToggleBlock}</div></div></header>`,
+        headerBlock,
         '<main>',
         `<article>${articleBody}</article>`,
         '</main>',
-        footerBlock,
+        renderedFooterBlock,
         searchScript,
         '</body>',
         '</html>',
     ].join('');
 }
+function getAbsoluteSiteAssetUrl(siteUrl, href) {
+    if (!href) {
+        return undefined;
+    }
+    if (/^[a-zA-Z][a-zA-Z\d+.-]*:/.test(href) || href.startsWith('//')) {
+        return href;
+    }
+    if (!siteUrl) {
+        return undefined;
+    }
+    return new URL(href.replace(/^\//, ''), `${siteUrl}/`).toString();
+}
 export function escapeHtml(value) {
     return value
         .replaceAll('&', '&amp;')

package/dist/index-builder.d.ts

@@ -1,13 +1,15 @@
+import { type MdoPlugin } from './core/extensions.js';
 export interface BuildIndexOptions {
     rootDir?: string;
     dir?: string;
+    plugins?: MdoPlugin[];
 }
 export interface BuildIndexResult {
     updatedFiles: string[];
     skippedDirectories: string[];
 }
 export declare function buildDirectoryIndexes(options: BuildIndexOptions): Promise<BuildIndexResult>;
-export declare function buildManagedIndexBlock(directoryPath: string): Promise<string>;
+export declare function buildManagedIndexBlock(directoryPath: string, plugins?: MdoPlugin[]): Promise<string>;
 export declare function upsertManagedIndexBlock(source: string, block: string, options?: {
     directoryPath?: string;
 }): string;

package/dist/index-builder.js

@@ -1,5 +1,6 @@
 import { readdir, readFile, realpath, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { applyIndexTransforms } from './core/extensions.js';
 import { inferDirectoryContentType } from './core/content-type.js';
 import { getDirectoryIndexCandidates } from './core/directory-index.js';
 import { getDocumentSummary, getDocumentTitle, parseMarkdownDocument, } from './core/markdown.js';
@@ -16,6 +17,7 @@ export async function buildDirectoryIndexes(options) {
         const directoryPath = path.resolve(options.dir);
         const updatedFile = await updateSingleDirectoryIndex(directoryPath, {
             createIfMissing: false,
+            plugins: options.plugins ?? [],
         });
         return {
             updatedFiles: updatedFile ? [updatedFile] : [],
@@ -29,6 +31,7 @@ export async function buildDirectoryIndexes(options) {
     for (const directoryPath of directories) {
         const updatedFile = await updateSingleDirectoryIndex(directoryPath, {
             createIfMissing: false,
+            plugins: options.plugins ?? [],
         });
         if (updatedFile) {
             updatedFiles.push(updatedFile);
@@ -55,7 +58,7 @@ async function updateSingleDirectoryIndex(directoryPath, options) {
     const existingContent = indexFilePath
         ? await readFile(indexFilePath, 'utf8')
         : '';
-    const block = await buildManagedIndexBlock(directoryPath);
+    const block = await buildManagedIndexBlock(directoryPath, options.plugins);
     const nextContent = upsertManagedIndexBlock(existingContent, block, {
         directoryPath,
     });
@@ -64,7 +67,7 @@ async function updateSingleDirectoryIndex(directoryPath, options) {
     }
     return targetFilePath;
 }
-export async function buildManagedIndexBlock(directoryPath) {
+export async function buildManagedIndexBlock(directoryPath, plugins = []) {
     const entries = await readdir(directoryPath, { withFileTypes: true });
     const directories = [];
     const articles = [];
@@ -118,7 +121,23 @@ export async function buildManagedIndexBlock(directoryPath) {
     }
     directories.sort(compareDirectories);
     articles.sort(compareArticles);
-    return renderManagedIndexBlock(directories, articles);
+    const transformedEntries = await applyIndexTransforms([
+        ...directories.map((entry) => ({
+            kind: 'directory',
+            title: entry.title,
+            href: entry.link,
+        })),
+        ...articles.map((entry) => ({
+            kind: 'article',
+            title: entry.title,
+            href: entry.link,
+            detail: [entry.date, entry.summary].filter(Boolean).join(' · ') || undefined,
+        })),
+    ], plugins, {
+        mode: 'build',
+        directoryPath,
+    });
+    return renderManagedIndexBlock(transformedEntries);
 }
 export function upsertManagedIndexBlock(source, block, options = {}) {
     const hasStart = source.includes(INDEX_START_MARKER);
@@ -137,20 +156,13 @@ export function upsertManagedIndexBlock(source, block, options = {}) {
     }
     return `${trimmed}\n\n${block}\n`;
 }
-function renderManagedIndexBlock(directories, articles) {
+function renderManagedIndexBlock(entries) {
     const lines = [INDEX_START_MARKER, ''];
-    if (directories.length > 0) {
-        for (const entry of directories) {
-            lines.push(`- [${entry.title}](${entry.link})`);
-        }
-        lines.push('');
-    }
-    if (articles.length > 0) {
-        for (const article of articles) {
-            lines.push(`- [${article.title}](${article.link})`);
-            const detail = [article.date, article.summary].filter(Boolean).join(' · ');
-            if (detail !== '') {
-                lines.push(`  ${detail}`);
+    if (entries.length > 0) {
+        for (const entry of entries) {
+            lines.push(`- [${entry.title}](${entry.href})`);
+            if (entry.detail) {
+                lines.push(`  ${entry.detail}`);
             }
             lines.push('');
         }

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { defineConfig, type SiteConfig, type UserSiteConfig, type SiteNavItem, type SiteLogo, type SiteSocialLink, type EditLinkConfig, } from './core/site-config.js';
+export type { MdoPlugin, PageRenderModel, RenderHookContext, IndexTransformContext, } from './core/extensions.js';

package/dist/index.js

@@ -0,0 +1 @@
+export { defineConfig, } from './core/site-config.js';

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "mdorigin",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
-  "description": "Markdown-first publishing engine with raw Markdown and HTML views.",
+  "description": "Markdown-first publishing for humans and agents.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jolestar/mdorigin.git"
   },
-  "homepage": "https://github.com/jolestar/mdorigin#readme",
+  "homepage": "https://mdorigin.jolestar.workers.dev",
   "bugs": {
     "url": "https://github.com/jolestar/mdorigin/issues"
   },
@@ -16,12 +16,18 @@
     "publishing",
     "static-site",
     "cloudflare-workers",
+    "agents",
+    "skills",
     "cli"
   ],
   "bin": {
     "mdorigin": "dist/cli/main.js"
   },
   "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
     "./search": {
       "types": "./dist/search.d.ts",
       "default": "./dist/search.js"
@@ -62,11 +68,11 @@
     "gray-matter": "^4.0.3",
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.1",
-    "remark-html": "^16.0.1"
+    "remark-html": "^16.0.1",
+    "tsx": "^4.20.5"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",
-    "tsx": "^4.20.5",
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {