Moldavite Markdown
Create Markdown that survives round trips through Moldavite's rich-text editor. Use standard Markdown plus only the Moldavite extensions documented here.
Workflow
- Read the Forge's
AGENTS.md when present. Forge-specific rules override this skill.
- Before editing an existing note, read its complete raw Markdown, including frontmatter.
- Preserve unknown frontmatter keys and unsupported content unless the user asks to change them.
- Use conservative Markdown: headings, paragraphs, lists, tasks, blockquotes, links, fenced code, and images.
- Connect notes with Moldavite wiki links. Use standard Markdown links for external URLs.
- Verify link order, tag syntax, frontmatter fences, and destination filename before writing.
Supported Markdown
# Heading 1
## Heading 2
### Heading 3
**bold** and *italic*
- Bullet
1. Ordered item
- [ ] Open task
- [x] Completed task
> Blockquote
[External link](https://example.com)
```text
Fenced code
```
Moldavite also round-trips underline, highlight, text alignment, and sized images as inline HTML. Do not introduce that HTML unless the task needs those editor features.
Frontmatter
Frontmatter is optional and must begin at the start of the file:
---
title: Project Alpha
status: active
color: moss
---
- Moldavite interprets
color; valid IDs are in SYNTAX.md.
- Other valid YAML keys are preserved, but Moldavite may reorder or reformat them on save.
- Frontmatter content is excluded from keyword and semantic search.
- Do not assume Obsidian properties such as
aliases, cssclasses, or frontmatter tags have app behavior.
Wiki Links
[[Target]]
[[Display text|target]]
Moldavite alias order is display text first, target second. This is opposite Obsidian's [[target|Display text]] order.
- Prefer
[[Target]] when display text can match the note title.
- Omit
.md from targets.
- Targets resolve by basename, not folder path. Avoid duplicate basenames across folders.
- Heading links, block links, and transclusion do not have native semantics.
- On Moldavite 1.7, rich-editor saves can collapse aliased links to their display text. Prefer plain links when practical.
See SYNTAX.md for target normalization and migration differences.
Tags
Use inline body tags:
#project #in-progress
- Start with an ASCII letter.
- Continue with ASCII letters, numbers, or hyphens.
- Tags are case-insensitive and normalized to lowercase.
- Nested tags such as
#project/alpha are unsupported.
- Frontmatter tags do not participate in Moldavite's tag index.
Unsupported Obsidian Syntax
Do not generate these as Moldavite features:
![[embeds]][[Note#Heading]] or [[Note#^block]] navigation> [!callout] callouts%%comments%%- Obsidian property semantics
.base or .canvas files
Plain Markdown may retain some syntax as literal text, but Moldavite does not provide the corresponding behavior.
1---2name: moldavite-markdown3description: Create and edit Markdown notes for Moldavite with supported frontmatter, wiki links, aliases, tags, task lists, and formatting. Use when writing .md files in a Moldavite Forge, converting Obsidian syntax, or when the user mentions Moldavite notes, wikilinks, note colors, frontmatter, or tags.4license: MIT5---67# Moldavite Markdown89Create Markdown that survives round trips through Moldavite's rich-text editor. Use standard Markdown plus only the Moldavite extensions documented here.1011## Workflow12131. Read the Forge's `AGENTS.md` when present. Forge-specific rules override this skill.142. Before editing an existing note, read its complete raw Markdown, including frontmatter.153. Preserve unknown frontmatter keys and unsupported content unless the user asks to change them.164. Use conservative Markdown: headings, paragraphs, lists, tasks, blockquotes, links, fenced code, and images.175. Connect notes with Moldavite wiki links. Use standard Markdown links for external URLs.186. Verify link order, tag syntax, frontmatter fences, and destination filename before writing.1920## Supported Markdown2122````markdown23# Heading 124## Heading 225### Heading 32627**bold** and *italic*2829- Bullet301. Ordered item31- [ ] Open task32- [x] Completed task3334> Blockquote3536[External link](https://example.com)3738```text39Fenced code40```41````4243Moldavite also round-trips underline, highlight, text alignment, and sized images as inline HTML. Do not introduce that HTML unless the task needs those editor features.4445## Frontmatter4647Frontmatter is optional and must begin at the start of the file:4849```yaml50---51title: Project Alpha52status: active53color: moss54---55```5657- Moldavite interprets `color`; valid IDs are in [SYNTAX.md](references/SYNTAX.md).58- Other valid YAML keys are preserved, but Moldavite may reorder or reformat them on save.59- Frontmatter content is excluded from keyword and semantic search.60- Do not assume Obsidian properties such as `aliases`, `cssclasses`, or frontmatter `tags` have app behavior.6162## Wiki Links6364```markdown65[[Target]]66[[Display text|target]]67```6869Moldavite alias order is display text first, target second. This is opposite Obsidian's `[[target|Display text]]` order.7071- Prefer `[[Target]]` when display text can match the note title.72- Omit `.md` from targets.73- Targets resolve by basename, not folder path. Avoid duplicate basenames across folders.74- Heading links, block links, and transclusion do not have native semantics.75- On Moldavite 1.7, rich-editor saves can collapse aliased links to their display text. Prefer plain links when practical.7677See [SYNTAX.md](references/SYNTAX.md) for target normalization and migration differences.7879## Tags8081Use inline body tags:8283```markdown84#project #in-progress85```8687- Start with an ASCII letter.88- Continue with ASCII letters, numbers, or hyphens.89- Tags are case-insensitive and normalized to lowercase.90- Nested tags such as `#project/alpha` are unsupported.91- Frontmatter tags do not participate in Moldavite's tag index.9293## Unsupported Obsidian Syntax9495Do not generate these as Moldavite features:9697- `![[embeds]]`98- `[[Note#Heading]]` or `[[Note#^block]]` navigation99- `> [!callout]` callouts100- `%%comments%%`101- Obsidian property semantics102- `.base` or `.canvas` files103104Plain Markdown may retain some syntax as literal text, but Moldavite does not provide the corresponding behavior.
mauropereiira