lossless-flavored-markdown

What problem does it solve?

Standard markdown lacks support for rich, structured content like styled callouts, hoverable citations, and embedded media, while MDX introduces JSX lock-in that ties content to specific frontend frameworks. This skill solves that by providing Lossless Flavored Markdown (LFM), a polyglot extended markdown spec that normalizes multiple syntax styles to a unified component pipeline, so teams can author content in their preferred tool (Obsidian, Astro, etc.) without sacrificing rich rendering capabilities.

Core Features & Use Cases

• Polyglot syntax normalization: Supports directive syntax, Obsidian callouts, Markdoc tags, and bare URLs, all rendering to the same consistent components so authors can use their preferred writing style without breaking site rendering.
• Built-in rich content triggers: Includes out-of-the-box support for styled callouts, hex-code citations with hover popovers, auto-embedded media (YouTube, Vimeo, etc.), link preview cards, image galleries, dialog blocks, and Mermaid diagrams.
• Customizable extensibility: Sites can extend LFM via three non-breaking layers (per-instance attributes, variant registry, CSS theme tokens) to add custom components or adjust styling without forking the core package.
• Cross-site consistency: Used across all Astro Knots sites to enforce uniform content rendering, frontmatter conventions, and citation rules across team projects.

Quick Start

Use this skill to add a styled warning callout, hex-code citation with hover preview, and embedded YouTube video to a markdown file in your Astro Knots site.