# Lossless Flavored Markdown

> Lossless Flavored Markdown

MDX power without MDX's opinions. **Lossless Flavored Markdown** (`@lossless-group/lfm`) is a polyglot extended-markdown pipeline: authors keep authoring in whatever syntax their tool prefers — Obsidian callouts, CommonMark directives, hex-code citations, bare URLs that should auto-unfurl — and `remark` plugins normalize every variation onto **one canonical MDAST shape** the renderer dispatches against. One AST, many authoring conventions, ready for any framework.

This site is the package's GitHub Pages splash. It catalogs 7 feature highlights, 1 syntax-trigger-component (STC) example(s), 6 changelog entries, and 7 context-v notes that document how LFM is built.

## Reference

- [Full-text search](https://lossless-group.github.io/lossless-flavored-markdown-package/search/): Pagefind-indexed across the changelog and context-v notes.
- [Full corpus content](https://lossless-group.github.io/lossless-flavored-markdown-package/llms-full.txt): every published changelog and context-v entry concatenated as raw markdown — preferred ingest target for LLMs that can handle a single large document.
- [Source repository](https://github.com/lossless-group/lossless-flavored-markdown-package): the package, the splash, the changelog, the context-v.
- [Package on JSR](https://jsr.io/@lossless-group/lfm): canonical install target.
- [Lossless Group](https://lossless.group): the org that maintains this practice.

## Features

The headline capabilities of `@lossless-group/lfm` — what ships in the box.

- [Polyglot pipeline](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): Many authoring conventions, one canonical AST. Authors pick the syntax their tool prefers; renderers see one shape.
- [remark-gfm](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): Tables, task lists, strikethrough, autolinks — GitHub-flavored markdown enabled by default.
- [remark-directive](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): Directive syntax for tagging blocks, leaves, and inline runs as components.
- [remark-callouts](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): Obsidian `> [!type] Title` blocks normalized into directive nodes — same downstream shape, two upstream syntaxes.
- [remark-citations](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): Hex-code footnotes get renumbered to display indices and lifted into a structured citation dataset.
- [link-preview · og-fetcher](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): Build-time OpenGraph enrichment. Cards and rollups carry full metadata before the page ships.
- [Bare-link provider catalog](https://lossless-group.github.io/lossless-flavored-markdown-package/#features): A URL on its own line becomes the embedded player or rich card the author meant. The catalog ships in the package.

## Examples

Syntax-Trigger-Component (STC) examples — one authoring shape, one normalizer plugin, one canonical MDAST node, one renderer.

- [Video Embeds](https://lossless-group.github.io/lossless-flavored-markdown-package/): bare URL or directive

## Changelog

Entry-by-entry release notes for the package, sorted by `date_modified` descending. Following the Lossless Group changelog conventions.

- [remarkLosslessWikilinks ships in 0.3.0 — site-resolved Obsidian wikilinks for the LFM pipeline](https://lossless-group.github.io/lossless-flavored-markdown-package/changelog/2026-05-08_02/): 0.3.0 lands a new plugin that turns Obsidian's [[Page|Display]] syntax into proper hyperlinks — with one design constraint baked in: LFM never decides where a wikilink points. Sites supply a resolver function; LFM owns the syntax. The package now does internal vs external routing, anchors, alias displays, and graceful plain-text fallback for unresolved links — all behind one new option on parseMarkdown.
- [New callout features in @lossless-group/lfm](https://lossless-group.github.io/lossless-flavored-markdown-package/changelog/2026-05-08_01/): remark-callouts grew up: multi-line callouts no longer silently fall through, hyphenated type names like [!llm-response] now parse, Obsidian's foldable [!type]- syntax is supported, and the pipeline doc codifies the policy that callout bodies must support every LFM feature — directives, citations, embeds, even nested callouts.
- [Initial pass at a Lossless Flavored Markdown splash page](https://lossless-group.github.io/lossless-flavored-markdown-package/changelog/2026-05-07_01/): LFM gets its own GitHub Pages landing page — three-stage STC diagram, asymmetric hero, manuscript-flavored type, and a package boundary that won't let the splash bleed into JSR.
- [LFM Inline Link Substitutions: OG fetch foundation + `:::link-preview` / `:::link-rollup` directives end-to-end](https://lossless-group.github.io/lossless-flavored-markdown-package/changelog/2026-05-03_01/): First end-to-end vertical slice of inline link substitution — URL classifier → OG fetcher → `:::link-preview` / `:::link-rollup` directives → Astro card renderer, with all eight spec formats rendering real OpenGraph metadata on the page.
- [remark-citations plugin — hex-code footnote renumbering and structured definition parsing](https://lossless-group.github.io/lossless-flavored-markdown-package/changelog/2026-04-22_01/)
- [Fixed Slides Directive Rendering in Reader Layout](https://lossless-group.github.io/lossless-flavored-markdown-package/changelog/2025-08-01_01/)

## Context-V

The context files, specs, blueprints, and reflections that shape how LFM is built. Versioned context, intentionally legible — alpha-sorted by title.

- [Conditional Component Rendering in Layout Pipelines](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Maintain-Conditional-Components-on-Render/): Implement flexible layout component rendering with optional parameter controls for InfoSidebar and TableOfContents suppression
- [Maintain an Elegant Markdown and Extended Markdown Render Pipeline](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Maintain-Lossless-Markdown-and-Extended-Markdown-Render-Pipeline/)
- [Maintain Directives In Extended Markdown Render Pipeline](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Maintain-Directives-in-Extended-Markdown-Render-Pipeline/): Directives bring MDX like component rendering using special extended markdown syntax. 
- [Maintain Embeddable Slides](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Maintain-Embeddable-Slides/)
- [Maintain Figma Object Embeds Using Embed Kit](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Maintain-Figma-Object-Embeds-using-Embed-Kit/): Embed live Figma files, frames, and prototypes inside markdown via the `:figma-embed` text directive — width, height, and auth-user as attributes.
- [Render AST in Debug](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Render-AST-in-Debug/): Exploration of AST structure at each stage of markdown processing to understand how to handle callouts
- [Workspace vs JSR for LFM Consumers](https://lossless-group.github.io/lossless-flavored-markdown-package/context-v/Workspace-vs-JSR-for-LFM-Consumers/): Why most consumer sites should pin @lossless-group/lfm to JSR while exactly one acts as the local workspace sandbox — and the boring deploy-host failure mode that forces the discipline.