The field guide

Notes about the plugin,
written in the plugin.

Four display notes that read like real pages from a working vault — callouts, tables, task lists, highlights, inline and fenced code, quotes, and multiple heading levels. Each one carries a real templar frontmatter block and is rendered here with the same compiled stylesheet the plugin generates inside Obsidian.

How a Page Is Compiled

A short walk through the compiler · form + function

Every styled note is wrapped in a scoped element — [data-templar-scope] — and receives exactly one generated stylesheet. Two panes showing the same note stay isolated from each other.

The scope in action

The generated CSS never touches body or global selectors. It opens with [data-templar-scope="templar-leaf-1"] and every rule descends from that root.

From frontmatter to pixels

templar:
  style-name: Bauhaus Review
  template-id: bauhaus-review
  paper:
    color: "#f3f0e5"
    pattern: graph
  baseline:
    enabled: true
    unit: 24
  typography:
    body-font: Futura, "Avenir Next", system-ui, sans-serif
    body-size: 15

The compiler measures real fonts, fits every element to the baseline grid, and emits one stylesheet — capped at 1 MiB for safety.

Safety boundaryValue
Generated stylesheet1 MiB maximum
Custom CSS selectorsValidated, then rewritten under the scope
Unknown style versionsRefused — protected data fails closed
Network requestsNone, ever

What the compiler does

  1. Parses the note's templar block into a validated style.
  2. Measures the body, all six headings, and code against real browser fonts.
  3. Emits paper, typography, blocks, lists, images, and attachments as scoped CSS.
  4. Compiles custom CSS last so it wins — still inside the scope.
Validation is not optional

Invalid selectors and unsafe values are rejected with an issue list, not silently rewritten. Protected data is never overwritten by a style upgrade.

The output

[data-templar-scope="templar-leaf-1"] .templar-page {
  background: #f3f0e5;
  color: #24292d;
  font-family: Futura, "Avenir Next", system-ui, sans-serif;
  font-size: 15px;
  line-height: 24px;
}
  • Scoped to one leaf
  • Real font metrics, not guesses
  • Baseline-aware after variable-height blocks

If you can read the compiled stylesheet, you can trust the page.

How a Page Is Compiled

Primary shapes, sharp grids, and functional geometric type.

TechnicalGraphInternals
View source note

Night Shift Notes

Notes after dark · 01:47 · dark pages, fixed canvases, small screens

Some reading happens at night, on screens, at full focus. Dark & Neon styles keep a page structured with grids and neon ink instead of sunlight.

Two ways a page can behave

PagelessPaged
FlowReflows like a normal noteFixed canvas, A4 or Letter
Narrow screensLines re-wrapThe whole sheet scales
Line breaksBrowser decidesExactly where you placed them
PrintingBest-effortPage-perfect

The paged contract

In paged mode the page keeps its stored width and height. When the pane narrows, the sheet scales as one unit — line breaks and page positions do not move.

A4     794 x 1123 px      scale-to-fit
Letter 816 x 1056 px      gaps aligned to the baseline grid
Custom any px pair       exported with the note

Print, mobile, sync

  • Print — fonts, images, and paper settle before the dialog opens.
  • Mobile — the same self-contained design renders in Obsidian mobile.
  • Sync — a three-way merge compares your applied snapshot, the updated source, and your local edits.
Review, don't overwrite

When a source style updates, Templar shows what changed instead of silently re-styling your note. Keep the safe parts; resolve the rest deliberately.

A dark page, up close

Field note, 01:47

The grid glows, the margins hold, and the words are exactly where I left them.

  1. Choose a dark style from Dark & Neon.
  2. Toggle Paged from the page-mode command.
  3. Drag the pane narrow — watch the sheet scale, not reflow.

Even the darkest page keeps its ruler lines.

Night Shift Notes

Purple night, laser grids, and a blazing synthwave sunset.

Dark & NeonPagedMobile
View source note

Templar Field Manual

Field Manual No. 01 · beta edition · last updated 14 Aug 2026

What I use this for

I keep a Templar style on the notes I read every day: the daily log, lecture summaries, and my study sheets. The design lives in one templar block at the top of the file, and the rest of the note stays plain Markdown.

What Templar is

Templar gives each note its own visual page design — paper, type, grids, and rules — while the note itself stays ordinary Markdown. The design travels with the file, and nothing about the writing changes.

Setup in three steps

  1. Install the beta through BRAT (repo: K0g1/Templar).
  2. Open any note and run Templar: Apply page style from the command palette.
  3. Search with /, press Enter to apply.
Try before you commit

Clicking a style only previews it on the real note. Nothing is written until you press Apply.

Command map

CommandWhat it does
Templar: Apply page styleAttaches a style to the open note
Templar: Browse page stylesOpens the style library
Templar: Toggle page modeSwitches pageless and paged
Templar: Print styled notePrepares paper and images for printing

What the design controls

  • Paper — ruling, dots, graph, ledger, scallops, and margin lines
  • Typography — body font, size, color, and all six heading levels
  • Baseline grid — text, tables, and images snap to the ruled rhythm
  • Page geometry — A4, Letter, or custom; pageless or paged

Daily routine

08:00  review yesterday's log
08:20  read through the lecture notes
09:00  copy the summary into the study sheet
Back up first

Templar is beta software. Back up important vaults before testing prerelease releases.


A page is still a note

Delete the templar property and the note is ordinary Markdown again. Content remains stable. Presentation can be expressive.

From the margin — refreshed with every release.

Templar Field Manual

Clear ruled notes with a strong cue column and study-friendly contrast.

AcademiaRuledQuickstart
View source note

The Style Library

A Sunday Supplement · One hundred and thirty-two page designs, thirteen packs

From the editor's desk

A style is not a theme. A theme dresses the whole vault; a style dresses one note — and it leaves the writing alone.

How the library is organized

Styles ship in themed packs, and every style answers one question: what should this particular note feel like?

PackMoodExample styles
EssentialsCalm everyday paperDaily Ruled, Clean Slate, Focus Dots
AcademiaStudy and lecturesCornell Lecture, Thesis Draft, Conference Notes
ProfessionalBriefs and decisionsExecutive Brief, Product Strategy, Sales Pipeline
TravelLogs and journeysTokyo Night, Desert Roadtrip, City Explorer
Dark & NeonScreen-first night pagesNeon Arcade, Synthwave Sunset, Ultraviolet Club
Vintage & EditorialPrint and pressSunday Supplement, 1920s Gazette, Paris Café

Finding the right page

  • Press / anywhere in the library to search.
  • Move with the arrow keys; press Space to preview on the real note.
  • Enter applies. A click only previews — Apply is always a separate, explicit step.
Search fields: name · folder · description · creator · tags
Densities:     Compact · Comfortable · Gallery
Surfaces:      Recent · Favorites · Current folder
Make it yours

Favourite the styles you return to. Templar sorts the ones you actually use toward the front — usage-aware, folder-aware, and reset-proof across restarts.

Where your own styles live

  • Save any preview as a custom style — edit its raw definition later.
  • Export a single .templar style file.
  • Export a validated multi-style .templar-pack.
  • Import both formats on any other device.
The library, summarized

Browse by feel, search by fact, preview instantly, apply deliberately, and keep the good ones.


One hundred and thirty-two styles is a lot of taste to carry around. Fortunately, they weigh less than the paper they imitate.

The Style Library

Warm newsprint, elegant serif copy, and magazine-red accents.

EditorialLibraryPacks
View source note

What each note demonstrates.

How a Page Is Compiled

  • Real YAML and CSS in code fences
  • Safety boundary table
  • Example callouts
  • The scoped-selector model
  • Style: Bauhaus Review (Vintage & Editorial)

Night Shift Notes

  • Pageless vs paged comparison
  • Print, mobile, and sync checklist
  • A midnight quote callout
  • The fixed-canvas contract
  • Style: Synthwave Sunset (Dark & Neon)

Templar Field Manual

  • Command map as a styled table
  • Tip and warning callouts
  • Checklists and a daily routine
  • Highlighted text and inline code
  • Style: Cornell Lecture (Academia)

The Style Library

  • Pack table across six moods
  • Quote and success callouts
  • Search, density, and favorites
  • Highlighted apply steps and code
  • Style: Sunday Supplement (Vintage & Editorial)

Build your own visual identity.

Install the beta, browse 132 styles, then make any one of them your own.