← Overview

<aside> 🔀

If you know OneLatex — the OneNote-based sibling of Obsitex — this page maps every concept you already know to its Obsitex equivalent. The ideas are the same; the syntax changed because the source is now Markdown in an Obsidian vault, not OneNote pages.

</aside>

Source and loading

OneLatex (OneNote) Obsitex (Obsidian)
A OneNote notebook Your Obsidian vault / project folder
A OneNote section The manuscript — the folder you convert
A OneNote page A Markdown (.md) file
Page name = section title Headings come from # lines, not file names
Page order in OneNote Flexplorer order, or number prefixes (01 , 02 )

Document structure — the page-name prefixes

In OneLatex you put a code at the start of a page name, and a page held a single section — so the code affected that one heading. In Obsitex the scope depends on where you write the setting: a heading attribute (on the # line) affects just that one heading, while a note property — Obsidian's Properties, stored as YAML frontmatter — affects the whole file:

OneLatex prefix Meaning Obsitex
%[N] No heading, just content Simply write no # line in the file
%[W] Unnumbered, no table-of-contents entry # Title {.unnumbered .unlisted}
%[U] Unnumbered, but listed in the ToC # Title {-} (or {.unnumbered})
%[R] Ignore the whole page the note property skip: true (or latex-remark: true)
%[>>] Add extra heading levels the note property latex-heading-offset (any integer) — shifts every heading in the file, not just one

More: Headings & structure and Comments & excluding content.

Special content blocks — the OneNote colors

In OneLatex you tagged special content by giving text a background color. In Obsitex you use a fenced code block with a tag (write three backticks immediately followed by the tag):

OneNote color Purpose Obsitex code block (tag)
Green Document settings (DDS) dds
Orange Preamble additions latex-preamble
Yellow (block) Raw LaTeX latex
Blue / aqua Remark (ignored) remark
Yellow (inline) Raw LaTeX inside a sentence a single-backtick span

Where each is covered: dds and latex-preamble on Document setup; the latex block on Text formatting; remark on Comments & excluding content. The word after the three backticks is the block's tag — it tells Obsitex how to treat the block; remark simply means “ignore this block”.

Remarks — keeping content out of the document

OneLatex had two ways to exclude content: the page prefix %[R] (a whole page) and the blue/aqua remark color (a block). Obsitex keeps both ideas and adds Obsidian's native comment syntax:

What to exclude How (Obsitex) Compared to OneLatex
A whole file the note property skip: true (or latex-remark: true) like %[R]
A whole block a remark code block like the blue/aqua color
A span or line, inline an Obsidian comment %%…%% new in Obsitex
A span or line, inline an HTML comment <!-- … --> new in Obsitex

Full details and examples: Comments & excluding content.

Elements

The same building blocks, now written in Markdown instead of drawn in OneNote:

Element Obsitex (Obsidian Markdown)
Bulleted list a line starting with -, * or +
Numbered list 1. item
Table GFM pipe table `
Image ![[image.png]]
PDF ![[file.pdf]]
Bibliography (.bib) ![[refs.bib]] embed

What changed conceptually