How-to · Knowledge & Research · By Steph Ango (Kepano / Obsidian)

How to use Obsidian Markdown in your AI agent

Install and use the Obsidian Markdown skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill helps you create notes in Obsidian using its special markdown features. You can link notes together, embed content from other files, add highlighted callouts, and organize everything with tags and properties. Perfect for building a personal knowledge base or team wiki without touching any code.

Step 1 — Get the skill source URL

The Obsidian Markdown skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown to my project.

Cursor

Install this agent skill: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown

Codex

Add this skill to .codex/skills/: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown

Gemini CLI

Add the skill at https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown

Windsurf

Add this skill: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Building a personal knowledge base or second brain in Obsidian
  • Organize project notes, meeting notes, or research with interconnected links
  • Create rich documentation with embedded images, PDFs, and cross-references
  • Managing a team wiki or shared knowledge repository

What this skill does

  • Links notes together automatically so you can build a connected knowledge graph
  • Embeds content from other notes, images, PDFs, and files directly into your current note
  • Creates highlighted callouts for warnings, tips, questions, and important information
  • Organizes notes with tags, properties, and frontmatter for easy searching and filtering
  • Formats notes with highlighting, footnotes, math equations, and diagrams
Made bySteph Ango (Kepano / Obsidian)
CategoryKnowledge & Research