Oyma supports the complete CommonMark standard, GitHub Flavored Markdown (GFM) extensions (tables, task lists, strikethrough), and Obsidian-compatible syntax (wikilinks, callouts, and YAML frontmatter).
Standards-Compliant CommonMark Foundation
The Markdown ecosystem has suffered from syntax fragmentation over the last two decades. Different parsers handle edge cases—such as nested lists, indented code blocks, and escaped characters—in incompatible ways.
Oyma resolves this by anchoring its parser to the rigorous CommonMark Spec (v0.30+), ensuring that documents you write in Oyma parse predictably in any compliant Markdown engine worldwide.
GitHub Flavored Markdown (GFM) Extensions
In addition to base CommonMark, Oyma natively supports all GitHub Flavored Markdown extensions:
- Tables: Full pipe table parsing with column alignment indicators (
:---,:---:,---:). - Task Lists: Interactive checkboxes (
- [ ] Pending,- [x] Completed). - Strikethrough: Standard double tilde syntax (
~~deprecated~~). - Autolinks: Instant clickable web URLs and email addresses.
- Footnotes: Numerical and named footnotes (
[^1]) with instant jump targets.
| Syntax Feature | CommonMark Core | GFM Extension | Oyma Native Support |
|---|---|---|---|
Headings (#) | Supported | Supported | Supported |
Tables (|) | Not in Core | Supported | Supported (with visual editor) |
| Task Checkboxes | Not in Core | Supported | Supported (interactive) |
Wikilinks ([[]]) | Custom | Custom | Supported (bidirectional) |
| Obsidian Callouts | Custom | Custom | Supported (styled banners) |
Math ($...$) | Custom | Custom | Supported (KaTeX engine) |
Obsidian-Compatible Syntaxes
To ensure frictionless interoperability with the broader personal knowledge management (PKM) community, Oyma supports:
- Bidirectional Wikilinks:
[[Note Title]]and aliased links[[Note Title|Custom Display Text]]. - Standard Callout Blocks: Obsidian-style callouts (
> [!NOTE],> [!WARNING],> [!TIP]). - YAML Frontmatter: Frontmatter blocks delimited by
---at the top of notes for tags and properties. - LaTeX Mathematical Notation: Inline math (
$E=mc^2$) and display equations ($$\sum_{i=1}^n i$$).
CommonMark Edge Cases and Deterministic Parsing
In addition to basic formatting, Oyma handles intricate CommonMark specification edge cases with mathematical precision:
- Nested Indented Lists: Seamlessly nest numbered lists within bulleted lists, complete with multiline code snippets and blockquotes without breaking list numbering.
- Escaped Special Characters: Full support for backslash escaping to ensure technical strings and mathematical symbols render exactly as intended.
- Fenced Code Blocks with Metadata: Multi-language syntax highlighting across 45+ languages (Rust, TypeScript, Python, Swift, Go, SQL, Bash) with support for line-number display and language tags.
- Auto-Formatting Shortcuts: Type
-or1.or>to start formatted blocks automatically without touching the mouse.
By honoring CommonMark v0.30+, your notes will render with identical fidelity in GitHub, GitLab, Hugo, Astro, Obsidian, and standard command-line tools.
Standards-Compliant Interoperability Across Toolchains
Because Oyma adheres strictly to the official CommonMark and GFM specifications, documents authored here can be processed by any standard static site generator, such as Astro, Next.js, Hugo, Jekyll, or Gatsby, with zero syntax transformation or cleanup required.
You can point documentation build pipelines directly at your Oyma vault folder in a continuous integration environment (such as GitHub Actions or GitLab CI) and compile technical white papers, developer wikis, or internal engineering handbooks directly from your raw Markdown files.
