Callouts, highlights & footnotes

Dense walls of monochrome text make technical documentation, meeting summaries, and research briefs difficult to parse. Important warnings get overlooked, critical action items blend into background descriptions, and tangential context clutters the primary narrative.

Traditional text editors offer rich text styling options, but they typically achieve this by wrapping your words in proprietary formatting or bloated HTML markup.

Oyma brings sophisticated editorial hierarchy to your notes while maintaining strict CommonMark plain text integrity. With native live-preview support for callouts, text highlights, margin comments, and academic footnotes, you can author expressive, structured documents that remain completely readable in any text reader.

Obsidian-compatible callout blocks

Callouts provide a structured visual container to highlight warnings, tips, crucial decisions, or supplementary information. In Oyma, callout blocks are built on standard blockquote syntax:

> [!NOTE] Architecture review
> System audio capture requires macOS 14.2 or later to tap loopback output streams.

> [!WARNING] Data boundary
> Do not configure external API keys in environments where all network traffic must remain air-gapped.

In the live-preview Markdown editor, the raw > markers and [!TYPE] headers transform into clean, border-accented callout containers with appropriate icon glyphs and background tints.

Standard callout types supported

Oyma includes built-in styling for all standard callout types:

• [!NOTE] and [!INFO]: General supplementary context, background details, and reference pointers.
• [!TIP] and [!HINT]: Helpful recommendations, workflow shortcuts, and performance advice.
• [!WARNING] and [!CAUTION]: Critical warnings regarding security constraints, breaking changes, or data boundaries.
• [!DANGER] and [!FAILURE]: High-priority alerts warning against destructive operations or irreversible decisions.
• [!SUCCESS] and [!CHECK]: Positive validation states, completed project milestones, and verified deliverables.
• [!QUOTE] and [!CITE]: Attributed quotations from team members, executive stakeholders, or external research papers.

Collapsible callouts for dense documents

When drafting comprehensive meeting notes or long-form technical runbooks, certain callouts contain auxiliary details that should not distract from the primary reading flow.

By appending a plus + or minus - sign to the callout identifier, you control its default collapse state:

> [!TIP]- Show terminal command examples
> You can verify local Ollama port availability by running:
> ```bash
> curl http://localhost:11434/api/tags
> ```

A collapsed callout renders with a subtle toggle chevron, allowing readers to expand the contents on demand without cluttering the screen.

Native text highlights for quick skimming

When reviewing extensive interview transcripts or analyzing architectural specifications, you often need to flag memorable quotes or pivotal numbers for quick retrieval.

Oyma supports standard markdown highlight syntax:

The team agreed to migrate the analytics pipeline ==by end of Q3== without adding third-party trackers.

In live preview, the double-equal signs conceal, applying a pleasant, low-contrast highlight tint that draws the eye during rapid scanning. Because the markup consists of pure ASCII characters, other Markdown tools like Obsidian and Bear render the identical visual emphasis.

Margin comments for asynchronous editorial review

Authoring documentation often involves drafting internal questions, self-reminders, or review notes that should not appear in final customer deliverables:

We are projecting 99.9% uptime for the on-device transcription engine. %% Alex: verify this benchmark against M1 base hardware before publishing %%

Using comment syntax (%%), Oyma renders your notes as muted marginalia. When you export your document to PDF, DOCX, or HTML, comment blocks are excluded automatically, ensuring private scratchpad thoughts never leak into public deliverables.

Scholarly footnotes for clean citations

Complex technical documents and customer case studies often require attribution, source citations, or explanatory clarifications that would derail the narrative flow if placed inline.

Oyma implements GitHub Flavored Markdown footnote definitions:

On-device models run with Metal acceleration[^1] across unified memory architectures.

[^1]: Benchmarks measured on Apple M3 Max hardware with 36 GB unified RAM.

Inline references render as interactive superscript numerals [1]. Clicking the reference navigates directly to the footnote definition, while clicking the return arrow beside the footnote jumps back to the exact paragraph where the thought originated.

Harmonizing editorial structure with meeting workflows

These typographical elements shine brightest when combined with automated meeting documentation. When you record a planning session with our zero-bot meeting recording and synthesize takeaways using local AI with Ollama, the resulting notes automatically utilize callout blocks for decisions, highlights for key metrics, and wikilinks for related documents.

Bring editorial clarity and visual polish to your personal knowledge repository with Oyma.