Index of every page on this site: llms.txt
All skills
obsidianmd avatar

/obsidian-markdown

@b110b2f
by Obsidianobsidianmd/obsidian-skills53k stars
3,795
Run it yourself

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

Use this Skill: https://skilld.dev/gh/obsidianmd/obsidian-skills/obsidian-markdown

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesPROPERTIES.md

≈366 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Properties (Frontmatter) Reference

Properties use YAML frontmatter at the start of a note:

---
title: My Note Title
date: 2024-01-15
tags:
  - project
  - important
aliases:
  - My Note
  - Alternative Name
cssclasses:
  - custom-class
status: in-progress
rating: 4.5
completed: false
due: 2024-02-01T14:30:00
---

Property Types

Type Example
Text title: My Title
Number rating: 4.5
Checkbox completed: true
Date date: 2024-01-15
Date & Time due: 2024-01-15T14:30:00
List tags: [one, two] or YAML list
Tags Only for the tags property

Links go in Text or List properties: related: "[[Other Note]]". Always quote wikilinks in YAML, because an unquoted [[Other Note]] is read as a nested list, not a link.

Default Properties

  • tags - Note tags (searchable, shown in graph view)
  • aliases - Alternative names for the note, offered in link suggestions. A bare [[Alias]] doesn't resolve; write [[Note|Alias]]
  • cssclasses - CSS classes applied to the note in reading/editing view

Tags

#tag
#nested/tag
#tag-with-dashes
#tag_with_underscores

Tags can contain: letters (any language), numbers, underscores _, hyphens -, forward slashes / (for nesting). A tag needs at least one non-numerical character (#1984book, not #1984), and a space ends it.

In frontmatter:

---
tags:
  - tag1
  - nested/tag2
---

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts7d3 checks · Risk SAFE
  • Gen Agent Trust Hub7d

    This skill provides instructions and syntax for creating Obsidian Flavored Markdown notes. It contains no executable code or malicious patterns.

  • Socket7d

    No alerts

  • Snyk7d

    Risk: LOW · No issues

Signed by skilld at b110b2f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 12 hours ago.

Activeupdated 2 weeks ago
  • obsidian
  • markdown
  • wikilinks
  • embeds
  • callouts
  • frontmatter
  • properties
  • note-taking
  • internal-links

README badge

README badge for obsidianmd/obsidian-skills/obsidian-markdown

Creates and edits Obsidian Flavored Markdown files with wikilinks, embeds, callouts, properties, and block references. Use this skill when working with .md files in Obsidian vaults or when the user requests Obsidian-specific syntax like internal links, frontmatter properties, or embedded content.

Generated from the current SKILL.md.

Does this skill cover standard Markdown syntax?
No. This skill focuses only on Obsidian-specific extensions like wikilinks, embeds, callouts, and properties. Standard Markdown (headings, bold, italic, lists, code blocks, tables) is assumed knowledge.
When should I use wikilinks vs. standard Markdown links?
Use wikilinks (`[[Note Name]]`) for notes within your Obsidian vault — Obsidian tracks renames automatically. Use standard Markdown links (`[text](url)`) for external URLs only.
Can I embed images and PDFs?
Yes. Use the `![[image.png|width]]` syntax for images and `![[document.pdf#page=3]]` for specific PDF pages. See EMBEDS.md for audio, video, and external image syntax.
What callout types are available?
Common types include note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, and todo. Callouts can have custom titles and be collapsed or expanded by default. See CALLOUTS.md for the full list.
How do I add metadata to a note?
Use YAML frontmatter at the top of the file with properties like title, tags, aliases, date, and cssclasses. See PROPERTIES.md for all available property types.

Generated from the current SKILL.md. These answers refresh after source changes.