Frontmatter

Frontmatter is metadata at the start of a Markdown document. mdedit.ai preserves YAML and TOML frontmatter and exposes a visual editor for common fields.

Visual frontmatter editor

YAML

---
title: Release notes
description: Changes in this version
tags:
  - product
  - docs
draft: false
---

TOML

+++
title = "Release notes"
draft = false
tags = ["product", "docs"]
+++

Keep the opening and closing delimiters at the start of the file. Invalid YAML or TOML remains visible as source, but metadata-driven features cannot use it until the syntax is fixed. Use the YAML specification (opens in a new tab) or TOML documentation (opens in a new tab) for the full syntax.

mdedit.ai render settings

The mdedit YAML object configures product-specific rendering. For example, a resume document can select a render profile, theme, page size, margin, and optional CSS:

---
mdedit:
  renderProfile: resume
  styles:
    theme: resume-template-1
    cssInline: |
      #resume-preview h2 { letter-spacing: 0.04em; }
  page:
    size: letter
    margin: 0.5in
---

Remote CSS is loaded only when the document explicitly allows it. It can fail offline or because of CORS, so keep essential styles inline. See Markdown resumes for the complete supported workflow.

Mermaid Diagrams Guides overview