Overview
v4.0.0
latestv3.0.0
v2.9.0
MRender v3.0.0
Highlights
- Added markdown frontmatter page options for layout and SEO.
- Added per-page TOC control and wide-content mode.
- Added reusable section configuration for docs/showcase/blog/releases.
- Added page-level origin link support for reposted articles (
origin, originLabel).
Who should upgrade
- Teams managing docs, blog, and release notes in one markdown system.
- Teams that need page-level SEO tuning without touching TypeScript config for every page.
- Teams migrating external articles (for example from Medium) and needing canonical source attribution in content.
Upgrade notes
- Keep existing
provideDocumentation usage.
- Add frontmatter keys only where page-level behavior should differ from global defaults.
- Move repeated section wiring into a shared section factory.
- Add origin frontmatter only for reposted content.
Frontmatter quick-start
Reusable section config pattern
Migration checklist
- Update project to v3.0.0 dependencies.
- Confirm all section routes still resolve markdown files.
- Add frontmatter only where needed.
- Validate TOC behavior on pages with
toc: false.
- Validate SEO tags on pages with custom frontmatter.
- Validate origin link rendering on reposted pages.
Validation
- Verify table of contents behavior on pages with
toc: false.
- Verify width expansion behavior on pages with
wideContent: true.
- Verify title/description/canonical/og/twitter tags for pages with SEO overrides.
- Verify origin block above content for pages with
origin.
- Run SSR/prerender and confirm no route errors.
Common pitfalls
wideContent has no visual effect if TOC is still enabled.
origin must be a valid URL; invalid values are ignored.
- Overusing page-level SEO overrides can make metadata inconsistent across a section.
- Forgetting validation in prerender can hide metadata issues until production.
In this article