Syntax
Zelares uses Markdown as the editor format, extended with a few conventions of its own for things plain Markdown doesn't cover, like callouts and internal links. This page documents what you can type directly and which items are also available from the context menu, so you can check exactly what's supported before you rely on it. Where a feature has its own page with a fuller explanation and examples, the feature name links there.
Compatibility
| Feature | Syntax | Status | Notes |
|---|---|---|---|
| Paragraphs | Blank line between blocks | Supported | Use blank lines to separate paragraphs. Normal Markdown whitespace collapsing applies in rendered content. |
| Line breaks | Two trailing spaces, then Enter | Supported | Use a hard line break when you need a new visual line inside the same paragraph. |
| Headings | # through ###### | Supported | Headings 1 through 6 are available from Markdown and the right-click Paragraph menu. |
| Bold, italic, bold italic | **bold**, *italic*, ***both*** | Supported | The context menu can toggle bold and italic on the current word or selection. |
| Highlight | ==highlight== | Supported | Highlight is available from the Format menu and in markdown examples. |
| Strikethrough | ~~removed~~ | Supported | Strikethrough is available from the Format menu. |
| Internal links | [[/path/to/file]] and [[file#heading|alias]] | Supported | Use workspace paths for predictable linking. Heading fragments and aliases are understood by link and backlink helpers. |
| Markdown links | [text](url-or-file.md) | Supported | Use Markdown links for external URLs or relative file targets. |
| External images |  | Supported | Use standard Markdown image syntax with a reachable image URL. Size suffixes are not documented as supported yet. |
| Blockquotes | > Quote | Supported | Quotes are available from the Paragraph menu. |
| Callouts | > [!NOTE] Title | Supported | The editor can insert callouts and edit common callout types from the callout context menu. |
| Lists | - item, * item, + item, 1. item | Supported | Bullet, numbered, and nested lists are supported. The context menu inserts bullet and numbered markers. |
| Task lists | - [ ] task and - [x] done | Supported | Task lists are available from the Paragraph menu. |
| Horizontal rules | ---, ***, or ___ | Supported | The context menu inserts --- as the default horizontal rule. |
| Inline code | `code` | Supported | Inline code is available from the Format menu. |
| Code blocks | ```language | Supported | Use fenced code blocks and add a language name for syntax highlighting. |
| Math | $inline$ and $$block$$ | Supported | The Format menu toggles inline math, and the Insert menu creates math blocks. |
| Comments | %%comment%% | Supported | Comments can be inserted from the Format menu. |
| Footnotes | [^1] and [^1]: note | Not inserted | The Insert menu shows a Foot Note item, but it does not insert a snippet yet. |
| Escaped Markdown | \*literal asterisk\* | Supported | Use a backslash before formatting characters when you want them to display as text. |
Quick example
---
tags: docs, example
---
# Project Note
This is **important**, ==highlighted==, and linked to [[/Formatting Examples/Headings]].
> [!TIP] Draft faster
> Use the context menu to insert tables, callouts, code blocks, and math blocks.
- [x] Write the outline
- [ ] Add examples
```mermaid
graph TD
A[Idea] --> B[Draft]
B --> C[Review]
```Related pages
For a friendlier walkthrough of the most common formatting, see Markdown Basics. For structured data grids, see Tables. For flowcharts and diagrams, see Mermaid Diagrams.