markdown-history

Generic markdown rendering + wiki-style linking + Git-based diff views for React projects.

• Render markdown with anchors and automatic links:
  • Rewrites relative .md/.mdx and [[WikiLinks]] (including #Section) to your app routes
• Show Git diffs with GitHub-like unified and split views
• Lightweight utilities to read Git history/diffs server-side

Install

pnpm add markdown-history

Usage (Next.js)

1) Render markdown with link rewriting

import { renderMarkdownWithLinks } from 'markdown-history';

const html = await renderMarkdownWithLinks(mdString, pagesIndex, path.dirname(sourcePath));

• pagesIndex: Array of { sourcePath: string; title: string; route: string }
• The plugin will rewrite [Link](../Some Page.md#Anchor) and [[Some Page#Anchor]] to /some-page#anchor

2) Diff views (client)

'use client'
import { UnifiedDiff, SplitDiff } from 'markdown-history';

export default function Diff({ diff }: { diff: string }) {
  return <UnifiedDiff diff={diff} />
}

3) Git utilities (server)

import { gitHistory, gitDiff, findGitRoot } from 'markdown-history';

const root = findGitRoot(process.cwd());
const relPath = 'docs/page.md';
const commits = gitHistory(relPath, 30);
const diff = gitDiff(relPath, commits[1].sha, commits[0].sha, { ignoreWhitespace: true });

Build

pnpm -C packages/blueprints-core build

Notes

• No WIN-specific logic; bring your own index of pages and routes
• Git commands execute in the nearest .git root (or pass cwd if needed)
• Unified/Split components expect CSS classes used in examples (diff-table/grid); adapt to your design

License

MIT (add your preferred license if publishing)