obsidian-markdown

$npx skills add kepano/obsidian-skills --skill obsidian-markdown
SKILL.md

Obsidian Markdown

This skill enables skills-compatible agents to create and edit valid Obsidian Flavored Markdown, including all Obsidian-specific syntax extensions. Obsidian uses a combination of Markdown flavors: - [CommonMark](https://commonmark.org/)

Obsidian Flavored Markdown Skill

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

Overview

Obsidian uses a combination of Markdown flavors:

Basic Formatting

Paragraphs and Line Breaks

This is a paragraph.

This is another paragraph (blank line between creates separate paragraphs).

For a line break within a paragraph, add two spaces at the end  
or use Shift+Enter.
`### Headings`
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Text Formatting

Style
Syntax
Example
Output
Bold
**text** or __text__
**Bold**
Bold
Italic
*text* or _text_
*Italic*
Italic
Bold + Italic
***text***
***Both***
Both
Strikethrough
~~text~~
~~Striked~~
Striked
Highlight
==text==
==Highlighted==
==Highlighted==
Inline code
code
code
code

Escaping Formatting

Use backslash to escape special characters:
LHOST_PH_1
Common characters to escape: \*, \_, \#, \``, |, ~`

Internal Links (Wikilinks)

Basic Links

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

Embeds

Embed Notes

__LHOST_PH_3__query tag:#project status:done LHOST_PH_4

Callouts

Basic Callout

LHOST_PH_5

Supported Callout Types

Type
Aliases
Description
note
-
Blue, pencil icon
abstract
summary, tldr
Teal, clipboard icon
info
-
Blue, info icon
todo
-
Blue, checkbox icon
tip
hint, important
Cyan, flame icon
success
check, done
Green, checkmark icon
question
help, faq
Yellow, question mark
warning
caution, attention
Orange, warning icon
failure
fail, missing
Red, X icon
danger
error
Red, zap icon
bug
-
Red, bug icon
example
-
Purple, list icon
quote
cite
Gray, quote icon

Custom Callouts (CSS)

LHOST_PH_6

Lists

Unordered Lists

LHOST_PH_7

Code

Inline Code

__LHOST_PH_8__javascript // Syntax highlighted code block function hello() { console.log("Hello, world!"); } __LHOST_PH_9__python

Python example

def greet(name): print(f"Hello, {name}!") LHOST_PH_10

Nesting Code Blocks

Use more backticks or tildes for the outer block:
__LHOST_PH_11__js console.log("Hello") LHOST_PH_12

Using Pipes in Tables

Escape pipes with backslash:
LHOST_PH_13

Math (LaTeX)

Inline Math

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

Block Math

__LHOST_PH_14__mermaid graph TD A[Start] --> B{Decision} B -->|Yes| C[Do this] B -->|No| D[Do that] C --> E[End] D --> E __LHOST_PH_15__mermaid sequenceDiagram Alice->>Bob: Hello Bob Bob-->>Alice: Hi Alice __LHOST_PH_16__mermaid graph TD A[Biology] B[Chemistry] A --> B class A,B internal-link; LHOST_PH_17

Properties (Frontmatter)

Properties use YAML frontmatter at the start of a note:
LHOST_PH_18

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
Links
related: "[[Other Note]]"

Default Properties

  • tags - Note tags
  • aliases - Alternative names for the note
  • cssclasses - CSS classes applied to the note

Tags

LHOST_PH_19
Tags can contain:
  • Letters (any language)
  • Numbers (not as first character)
  • Underscores _
  • Hyphens -
  • Forward slashes / (for nesting)

HTML Content

Obsidian supports HTML within Markdown:
__LHOST_PH_20__python def process_data(items): return sorted(items, key=lambda x: x.priority) ## Architecturemermaid graph LR A[Input] --> B[Process] B --> C[Output] B --> D[Cache]

## Related Documents

- ![[Meeting Notes 2024-01-10#Decisions]]
- [[Budget Allocation|Budget]]
- [[Team Members]]

## References

For more details, see the official documentation[^1].

[^1]: https://example.com/docs

%%
Internal notes:
- Review with team on Friday
- Consider alternative approaches
%%

References