Hubbestaiskill.com

Home / All Skills / Content & Media Creation / obsidian-markdown

Content & Media Creation · freestylefly/canghe-skills

obsidian-markdown

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.

L1 Basic · Source registration onlyV1 Commit-PinnedDual-pass Audit

Author freestyleflyGitHub freestylefly/canghe-skills ↗License MIT（仓库根 LICENSE）Commit dd0bf35595

Control levels describe skill capabilities and suggested control measures; they do not represent quality or safety certifications, nor do they dictate usability. Usage decisions rest entirely with users and administrators. Different agent hosts apply varying constraints; do not assume hosts provide automatic protection. Third-party skill copyrights belong to their original authors. Use at your own risk.

1How It Works & Mechanism

Pure knowledge-injection skill: SKILL.md embeds all extended syntax of Obsidian Flavored Markdown into the model's context, enabling it to generate valid .md files—without scripts, network access, or dependencies.

skills/obsidian-markdown/SKILL.md

This skill enables skills-compatible agents to create and edit valid Obsidian Flavored Markdown, including all Obsidian-specific syntax extensions.

What this does: Defines the skill's boundary as "reading and writing Obsidian Flavored Markdown".

First outlines dialect composition: A combination of CommonMark + GFM + LaTeX + Obsidian-specific extensions.

skills/obsidian-markdown/SKILL.md

Obsidian uses a combination of Markdown flavors:

What this does: Maps each subsequent syntax block to its respective specification layer.

Internal links use wikilinks, supporting headings, block references, search links, and alias displays, with explicit block ID definition syntax provided.

skills/obsidian-markdown/SKILL.md

Define a block ID by adding `^block-id` at the end of a paragraph:

What this does: Pairs [[Note#^id]] with the ^id definition, clarifying the key mechanism for linkable blocks.

Markdown-style links require spaces to be URL-encoded as %20, and support the obsidian:// URI scheme.

skills/obsidian-markdown/SKILL.md

Note: Spaces must be URL-encoded as `%20` in Markdown links.

What this does: Highlights specific nuances differing from standard Markdown.

Embed syntax covers notes/images/audio/PDFs/lists/query results, and supports resizing parameters.

skills/obsidian-markdown/SKILL.md

![[image.png|640x480]] Width x Height

What this does: Demonstrates embed sizing syntax using concrete examples.

Callouts feature a fixed type table (13 types including note/info/tip/warning) with aliases, plus collapsible states and nesting support.

skills/obsidian-markdown/SKILL.md

### Supported Callout Types

What this does: Comprehensively details callout types, aliases, colors, and icons in one place.

Properties (frontmatter) distinguish data types and list default fields: tags/aliases/cssclasses.

skills/obsidian-markdown/SKILL.md

Properties use YAML frontmatter at the start of a note:

What this does: Standardizes note metadata formatting.

Math utilizes LaTeX (inline $...$ / block $$...$$), diagrams use Mermaid, and a complete comprehensive example is included.

skills/obsidian-markdown/SKILL.md

This is inline math: $e^{i\pi} + 1 = 0$

What this does: Covers mathematical and diagrammatic capabilities commonly required in academic note-taking.

2Core Capabilities

01Wikilinks internal linking: alias display, heading/block anchors, search links

02Block references: ^block-id definition and [[Note#^id]] referencing

03Embeds: notes/images (with dimensions)/audio/PDFs (page-specified)/lists/query results

04Callouts: 13 types including aliases, custom titles, collapsible and nested states, custom CSS

05Properties frontmatter: type differentiation and default fields tags/aliases/cssclasses

06Math (inline/block LaTeX), Mermaid diagrams (flowchart/sequence/internal-link)

07Tables with alignment, pipe escaping, and code blocks (including nesting techniques)

08Tag syntax (nested/hyphen/underscore), comments, footnotes, and HTML content

4Recommended Governance & Evidence

Suggested Controls for Safe Operation

For Agent Runtime

Can be auto-loaded

For Administrators

Register source and version

Evidence & Triggers (File Paths & Excerpts)

SKILL.md: Pure prompt instructions and rule text; no script execution or external impact

Audit Notes: Pure instruction-based: Single-file SKILL.md (621 lines) consists entirely of syntax specifications. §3 scan shows no script execution, network requests, credential access, or disk writes; zero danger flags. Directory contains only one file.

5Second-Pass Verification

[ok] 文件面核对 — §1 仅 skills/obsidian-markdown/SKILL.md（10813 字节 / 621 行），无 scripts/references/assets。
[ok] URL 命中性质复核 — §3 的 14 条 URL：commonmark.org/gfm/latex 与 help.obsidian.md 为文档链接，example.com 两条为示例占位符；均非运行时调用。
[ok] 安全结论反例搜索 — §3 凭证/外部程序/写盘/网络请求/危险旗标全部无命中。
[ok] 能力是否夸大 — description 声明的 wikilinks/embeds/callouts/properties 在 §2 均有独立章节与示例。
[ok] 档位判定复核 — 纯指令单文件、无任何执行面 → 🟢 green 成立。

6Verdict & Scenarios

Comprehensive coverage of Obsidian Flavored Markdown, replacing the need to consult official syntax docs with a single file.

Comprehensive example ready for direct reference, including frontmatter/wikilinks/callouts/mermaid/footnotes/comments.

Tabular syntax quick-reference with minimal lookup overhead.

Best for: Users writing/editing notes in Obsidian: requiring standardized syntax for wikilinks, callouts, frontmatter, embeds, math, and Mermaid; injecting Obsidian dialect knowledge to prevent syntax errors.

Not for: Non-Obsidian Markdown scenarios (standard GFM/CommonMark does not require this skill); scenarios requiring the skill to directly render or preview output; scenarios requiring high-frequency synchronization with the latest upstream syntax.

Install Agent-Ready

① Verified Mirror 2026-10-10

Option A · Direct DownloadDownload obsidian-markdown.tar.gz

sha256: 0fe5017b220b50e4…

Option B · Copy Guide for Agent

Agents automatically download and verify mirrors from this JSON guide.

② Upstream GitHub

GitHub Repo ↗

Pinned to commit dd0bf35595.