Tiptap Semantic Links

Tiptap Semantic Links is the official Tiptap/ProseMirror extension for the Semantic Markdown protocol.

It enables a high-fidelity editing experience where rich annotations (highlights, comments, AI tags) round-trip perfectly between a visual editor and a standard Markdown file.

Why this extension?

Standard WYSIWYG editors often struggle with "sticky" metadata. If you bold a word inside a comment, most editors split the comment into two pieces.

This extension implements Automatic Fragment Merging—it re-stitches overlapping marks back into a single, clean metadata entry during the save process.

Key Features

• Visual Continuity: Set to a high priority, ensuring annotations wrap around all other formatting (bold, italic) into a single, continuous highlight box.
• Smart Colors: Stores colors (including modern spaces like OKLCH) in the metadata footer rather than messy inline CSS.
• Self-Healing: Designed to handle git merge conflicts by automatically cleaning up "orphan" marks that no longer have corresponding metadata in the footer.
• Agnostic: Uses data-semantic-id attributes to remain neutral about what the metadata actually contains.

Integration

Used as the primary rendering engine for the Meechi editor, this extension ensures that what you see on the screen is exactly what is stored in your portable .md files.

Open Source

The extension is open source and can be used to add portable annotation support to any Tiptap-based project.

• NPM: @meechi-ai/tiptap-semantic-links (opens in a new tab)
• GitHub: luismichio/tiptap-semantic-links (opens in a new tab)