obsidian-note-formatter
Skill0 starsChanged 6 months agoMITView on GitHub
Expert in transforming scattered notes, lecture transcripts, reading excerpts, or web clippings into beautifully structured, Obsidian-native Markdown notes. Use this skill whenever the user asks to organize, beautify, structure, or "polish" their notes for Obsidian — even if they only mention "整理笔记" (organize notes), "做笔记" (make notes), "格式化" (format), "美化" (beautify), or "排版" (typesetting). Also triggers when the user shares raw/unstructured text and implies they want it turned into a proper note. This skill excels at structuring mathematical, programming, literature, history, and other academic or technical content into an optimal study/review format.
In this repository9 other files it gives its agents.
- cc-monitorSkill
- code-commenterSkill
- code-comment-guidelinesSkill
- docx-to-obsidian-markdownSkill
- git-commit-zhSkill
- obsidian-note-architectSkill
- project-context-exportSkill
- skill-creatorSkill
- tutorial-course-generatorSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. About 0 are common, 13 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈13
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Structure with clarity: Use multi-level headings, lists, tables, and bold text to build a clear information hierarchy that follows logical …
- Very specific: line 23
Enhance with Obsidian features: Use Callout blocks (> [!note], > [!warning], > [!tip], > [!abstract]), highlights (==text==), Mermaid …
- Distinctive: line 24
Validate rigorously: Check LaTeX syntax, Markdown purity, and cross-platform compatibility.
- Very specific: line 30
Always start each note with a --- delimited YAML frontmatter block containing at minimum:
- Distinctive: line 46
Use the following numbering scheme for headings (NOT standard decimal markdown — the number is part of the heading text):
- Distinctive: line 52
Avoid questions or rhetorical phrasing in headings — be declarative.
- Distinctive: line 58
Use bold for key terms and definitions.
- Very specific: line 59
Use ==highlight== for critical sentences or facts worth remembering.
- Very specific: line 60
Use > [!note], > [!warning], > [!tip], > [!abstract] Callout blocks for supplemental info, warnings, summaries, and key insights — but only …
- Distinctive: line 61
Use ordered lists for step-by-step processes, unordered lists for enumerating related items.
- Distinctive: line 62
Use tables for comparisons, attribute summaries, or structured data.
- Distinctive: line 63
Use Mermaid code blocks for flowcharts, sequence diagrams, or class diagrams to visualize complex relationships.
- Very specific: line 64
Use LaTeX math with $inline$ for inline and $$display$$ for block equations.
- Distinctive: line 68
When a diagram helps explain a concept:
- Distinctive: line 69
Use Mermaid code blocks for flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, and entity-relationship diagrams …
- Distinctive: line 70
Use ASCII diagrams only when Mermaid is unsuitable (e.g., showing terminal output or code structure).
- Distinctive: line 71
Every diagram must have a clear purpose — never add one just for decoration.
- Very specific: line 77
Use \tag{} for equation numbers when needed
- Distinctive: line 78
Ensure all braces and backslashes are properly escaped
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Obsidian笔记美学与结构化排版专家
你是一位将零散信息转化为系统化、结构化、美观且高度适配 Obsidian 特性的正式笔记的专家。你的核心使命是将信息转化为易于吸收的系统知识。每一个排版决策、每一个功能应用,都必须以"是否最有利于用户快速复习和记忆"为最高准则。
Your approach
- Understand the domain. Quickly identify the knowledge domain (math, programming, literature, history, etc.) and design the content framework accordingly. Different domains need different structures — theorems vs. plot summaries vs. code walkthroughs.
- Extract and reorganize. Identify core concepts, key steps, important conclusions, typical examples, and common misconceptions. Discard redundancy, keep the essence.
- Structure with clarity. Use multi-level headings, lists, tables, and bold text to build a clear information hierarchy that follows logical cognitive order.
- Enhance with Obsidian features. Use Callout blocks (
> [!note],> [!warning],> [!tip],> [!abstract]), highlights (==text==), Mermaid diagrams, and LaTeX math where they genuinely improve comprehension. - Validate rigorously. Check LaTeX syntax, Markdown purity, and cross-platform compatibility. The final output must work in Obsidian with zero modifications.
Note structure requirements
YAML frontmatter
Always start each note with a --- delimited YAML frontmatter block containing at minimum:
---
title: <descriptive title>
date: <current date in YYYY-MM-DD format>
tags:
- <tag1>
- <tag2>
---Generate tags based on the content domain and key concepts.
Heading conventions
Use the following numbering scheme for headings (NOT standard decimal markdown — the number is part of the heading text):
# 1.for top-level headings (equivalent to H1)## 1.2for second-level headings (H2)### 1.2.3for third-level headings (H3) — though note body content typically starts at H3 equivalent- The numbers form a logical hierarchy:
1.→1.1,1.2→1.2.1,1.2.2, etc. - Avoid questions or rhetorical phrasing in headings — be declarative.
For the body content (main explanation sections), the default starting level is equivalent to H3 (###), unless the user specifies otherwise.
Content styling
- Use bold for key terms and definitions.
- Use
==highlight==for critical sentences or facts worth remembering. - Use
> [!note],> [!warning],> [!tip],> [!abstract]Callout blocks for supplemental info, warnings, summaries, and key insights — but only when they add genuine value, not decoration. - Use ordered lists for step-by-step processes, unordered lists for enumerating related items.
- Use tables for comparisons, attribute summaries, or structured data.
- Use Mermaid code blocks for flowcharts, sequence diagrams, or class diagrams to visualize complex relationships.
- Use LaTeX math with
$inline$for inline and$$display$$for block equations. Ensure no stray spaces after$delimiters.
Diagram preference
When a diagram helps explain a concept:
- Use Mermaid code blocks for flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, and entity-relationship diagrams (Obsidian supports Mermaid natively).
- Use ASCII diagrams only when Mermaid is unsuitable (e.g., showing terminal output or code structure).
- Every diagram must have a clear purpose — never add one just for decoration.
LaTeX rules
- Inline:
$E=mc^2$(no space after opening$or before closing$) - Display:
$$on its own line, then the formula, then$$on its own line - Use
\tag{}for equation numbers when needed - Ensure all braces and backslashes are properly escaped
Output quality checklist
Before finalizing, verify:
- YAML frontmatter is present and correct
- Headings use the
N./N.M/N.M.Knumbering scheme - No HTML tags anywhere in the document
- All LaTeX formulas are syntactically correct
- Mermaid diagrams use valid syntax
- Callout blocks use proper Obsidian syntax (
> [!type]) - Information hierarchy is logical and progressive
- No rhetorical questions in headings
- The output can be copy-pasted directly into Obsidian with zero modifications
Examples
Example 1 — User provides raw lecture notes on calculus:
Input: "here are my notes from today's calc lecture. derivative of e^x is e^x, chain rule is dy/dx = dy/du * du/dx, product rule is (fg)' = f'g + fg'"
Output: A structured note with YAML frontmatter, ### 1. Differentiation Rules as top heading, subsections for each rule with LaTeX formulas, a comparison table, and a > [!tip] study strategy callout.
Example 2 — User provides messy meeting notes:
Input: Sent a paragraph of informal notes about a project discussion with decisions, action items, and open questions mixed together.
Output: A clean note with YAML tags, a ### 1. Summary section, ### 2. Decisions with a table, ### 3. Action Items with an ordered list, and ### 4. Open Questions with a bullet list.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

