01Keep Markdown
No manual copying into a database. Existing headings, code fences, tables and links continue to work.
The website system
One brand. Four publishing modes.
Each template serves a different reader intent while sharing the same navigation, tokens, typography and components. The distinction lives in layout—not a separate content workflow.
01 / THOUGHT LEADERSHIP
Article
Editorial hierarchy, readable long-form typography, sticky table of contents, code examples and contextual product conversion.
Open article template →02 / COMMERCIALProduct
Outcome-led positioning, plan selection, capability matrix, comparison table and a direct path into checkout.
Open product template →03 / EDUCATIONCourse
Transformation promise, learning outcomes, expandable curriculum, instructor authority and enrollment flow.
Open course template →04 / TECHNICAL REFERENCEDocumentation
Searchable navigation, breadcrumbs, version context, code blocks, parameter tables and deep-linkable headings.
Open documentation template →VuePress migration model
Move the theme around the content—not the content around a new system.
Your Markdown pages, directory structure and public URLs remain the durable layer. The rebrand becomes a VuePress custom theme that selects the correct layout from frontmatter or the existing route family.
02Preserve routes
/article/* and /reference/* retain their current URL meaning and search equity.
03Add frontmatter
Only commercial and course pages need extra structured fields for price, CTA, curriculum or plan data.
04Isolate checkout
Braintree Drop-in remains one Vue component backed by the existing secure server endpoints.
Recommended route map
Stable URLs make migration boring—in the best way.
| Content | Route family | Layout selection |
|---|---|---|
| Articles and how-to guides | /article/:slug | Automatic ArticleLayout |
| Developer references | /reference/:section/:slug | Automatic DocsLayout |
| Product pages | /product/:slug | Frontmatter layout: product |
| Courses | /course/:slug | Frontmatter layout: course |
| Payment | /checkout | Dedicated checkout application shell |