Live-preview Markdown editor

For decades, writing in plain Markdown forced writers into an awkward compromise: either stare at raw syntax markers (asterisks, brackets, and pipe symbols) in a plain code editor, or split your screen into two side-by-side panes where one side shows raw code and the other shows a rendered HTML preview.

Split-pane editing cuts your available screen space in half and forces your eyes to constantly dart back and forth between input and output. Traditional WYSIWYG word processors solve the visual problem but introduce proprietary binary formats, messy HTML exports, and vendor lock-in.

The Oyma live-preview editor removes this friction entirely. It renders formatted typography, interactive tables, styled callouts, and clean link chips directly in place as you type—while keeping the underlying file 100% standard, portable Markdown on your Mac.

How live preview works: decoration without mutation

The core engineering principle of Oyma‘s editor is decoration without mutation. The editor never injects invisible HTML wrappers, binary formatting tokens, or custom metadata tags into your documents to make them look good.

1. Active syntax concealment

When you type # Project Brief, the editor recognizes the heading level and renders the text in display typography while concealing the # marker. When you place your cursor at the beginning of the line to edit it, the # marker instantly reappears. As soon as you navigate away, the syntax conceals again.

2. Interactive inline structures

Elements that are traditionally clumsy to edit in raw plain text become fluid and intuitive:

• Spreadsheet-like tables: Instead of manually aligning ASCII pipes (|---|---|), tables render with real borders, sortable column headers, and cell-to-cell navigation via Tab and Enter.
• Callout blocks: Callouts (> [!note], > [!warning]) render with styled accent borders, subtle backgrounds, and recognizable iconography.
• Wikilinks and external links: [[Product Roadmap|Roadmap]] displays as a clean clickable chip. ⌘-click opens the target note, while clicking directly into the text reveals the full bracketed target for editing.
• Code fences: Fenced blocks render with monospace formatting, line numbers, and language labels while preserving raw indentation.

3. File integrity guarantee

Every change you make writes directly to plain .md files on your local drive. If you close Oyma and open your vault in VS Code, Obsidian, or the macOS Terminal, every file contains pristine, human-readable Markdown.

Worked sequence: from rough thought to structured document

Here is how writing in the live-preview editor unfolds in daily practice:

Step 1: Rapid drafting without distraction

You start typing without touching a toolbar or formatting palette:

• Type - [ ] to create a live task checkbox.
• Type [[ to trigger instant note autocomplete across your entire vault.
• Type == to highlight crucial phrases in yellow ink.

Because syntax markers collapse into clean typography as you move forward, your attention remains focused on the flow of reasoning rather than syntax punctuation.

Step 2: In-place table manipulation

Working with data in raw Markdown is notoriously tedious. In Oyma:

• Paste a spreadsheet snippet from Excel, Numbers, or CSV: the editor automatically constructs a clean Markdown table.
• Press Tab to jump between cells, or Enter to add a new row.
• Reorder columns or sort values alphabetically without touching raw pipe syntax.

Step 3: Verifying source boundaries

When working with complex documents containing frontmatter, metadata properties, or embedded code snippets, you can verify exact token boundaries at any moment:

• Press ⌘⇧R or open the Command Palette (⌘O) to toggle into raw Source Mode.
• Review raw YAML lines or multi-line block syntax.
• Toggle back to Live Preview with zero reload delay.

Supported inputs, outputs, and syntax specifications

The editor engine implements a comprehensive, verified syntax parser:

Syntax construct	Source representation	Live preview appearance
Headings	# Heading 1 to ###### Heading 6	Proportional display hierarchy with folding controls
Wikilinks	[[Note]] or [[Note|Alias]]	Interactive note chips; ⌘-click navigation
Callouts	> [!info] Summary note	Styled container with icon and accent bar
Tables	| Name | Status |	Interactive grid with column resize and cell navigation
Highlights	==crucial point==	Tinted text highlight
Comments	%%internal draft note%%	Subdued dim text, excluded from exports
Footnotes	[^1] and [^1]: Source text	Interactive footnote references with popover preview
YAML Frontmatter	--- key-value pairs ---	Structured metadata properties card at document top

Boundaries and honest limitations

To maintain complete product truth and adhere to our strict verification standards, the live-preview editor has defined boundaries:

• Mac-first desktop application: The editor runs in the native Oyma macOS desktop client. It is engineered specifically for macOS typography, keyboard conventions, and system performance.
• No proprietary canvas translation: While standard Markdown files render cleanly, proprietary .canvas diagram files or third-party plugin runtimes (such as Dataview scripts) remain inert code blocks.
• Private beta access: The desktop application is currently accessible to invited beta testers (site.cta = 'waitlist'). While you wait for an invite, all syntax specifications and file conventions are 100% compatible with existing open Markdown tools.

Related public resources

You can start using these file standards and workflows right now without waiting for app access:

• Markdown basics guide: Detailed reference for supported Markdown syntax and formatting rules.
• Opening an Obsidian vault: How Oyma reads your existing vault folder with zero conversion.
• Vault health inspector: Free browser tool to audit links, headings, and attachments across your notes before organizing them.
• Meeting record builder: Free browser utility to turn rough meeting notes into structured decision logs.