Skip to content → Skip to footer →

💜 Obsidian - Style Conventions


ATOM 104 words last modified 47 days ago
☑️ terms Terms of Service
By reading, you agree to the site's Terms of Service — TL;DR: doubt and fact-check everything I've written!

Markdown is a wide spec that accommodates a variety of use-cases, but Markdown-in-Obsidian suggests certain “best practices” that best fit the environment.

Goals

  • ⏰ Encourage long-term maintainability
  • 🧱 Enforce standard, systematic, and predictable design patterns
  • 🧠 Reduce mental cognitive load (during both writing, and retrieval)
  • 📤 Make notes portable (especially ready for publishing to the web)

Categories

  • Obsidian x Markdown - Style Guide - Naming
  • Filesystem
  • Knowledge
    • Reference vs. Resource vs. Reflection
    • Non-md files
    • Assets, Clips, Lit Notes
  • Metadata
    • Avoid repetitive note clutter (e.g. breadcrumb structure, journal footer meta)
  • Workflow
    • Inbox folder (not working. frontmatter property?)
    • Publishing
  • Note structure
    • Callouts

↗ External Resources