Skip to main content

MasterStyles Manual (Markdown + HTML)

MasterStyles is a view mode. It makes deliverables look finished without changing the original content. Think of it as a clean suit for your work, not a rewrite.

Feature Objective​

Give you presentation-grade documents on demand while keeping the source clean and editable.

How to Access​

  1. Open a Markdown or HTML deliverable in the Peek Drawer.
  2. Open the menu (three dots).
  3. Toggle MasterStyles on or off.

Shortcut: Cmd/Ctrl+Shift+V.

What Happens When You Toggle​

MasterStyles ON

  • Markdown becomes a styled HTML document using official templates.
  • A :::sidenotes block activates a two-column layout.
  • HTML variables receive a style override so they match the Masterminds look.

MasterStyles OFF

  • Markdown shows as clean text without layout tags.
  • HTML variables keep their original styling.
  • If the markdown only has frontmatter (no heading), the frontmatter title/subtitle/date/author are shown at the top to keep the document readable.

Markdown Authoring That Always Works​

Frontmatter (Optional, but Best)​

Use frontmatter to control the hero and metadata:

---
title: "Executive Summary"
subtitle: "Market signal review"
doc_type: "Document"
hero_tag: "Strategy"
date: "2026-01-19"
layout: two_col
---

If you skip title, the first heading becomes the hero title automatically. If MasterStyles is off and your Markdown already starts with a heading, MasterStyles will not repeat frontmatter fields.

Two Columns (Sidebar)​

:::sidenotes
### Summary
- Key risks
- Next steps
:::

Cards and Callouts​

:::card[Key Insight]
A concise takeaway.
:::

:::callout
One bold line that should stand out.
:::

Grid Layout​

:::grid{cols=2}
:::card[Problem]
...
:::
:::card[Impact]
...
:::
:::

Admonitions (Docusaurus Style)​

:::note
Baseline context.
:::

:::warning
A caution that matters.
:::

When to Use 1 Column​

Choose layout: one_col when you have wide tables or big diagrams. It gives them room to breathe and keeps the layout clean.

Fast Track (60 Seconds)​

  1. Add :::sidenotes if you want a sidebar.
  2. Toggle MasterStyles on.
  3. Share the styled output in seconds.

Share & Export​

  • Copy Rendered: copies the MasterStyles HTML (not raw Markdown).
  • Download → MasterStyles (HTML):
    • Markdown variables → styled HTML export.
    • HTML variables → original HTML with MasterStyles theme overlay.

FAQ​

Q: Does MasterStyles change my saved Markdown?
A: No. It only changes how it is displayed.

Q: Why did my sidebar not appear?
A: You need a :::sidenotes block for two-column layout.

Q: Can I keep HTML styles unchanged?
A: Yes. Turn MasterStyles off and HTML keeps its original styling.