Plugins
Emoji
nizel-plugin-emoji replaces known :name: shortcuts with emoji before Markdown is parsed.
Fenced code blocks and inline code spans are preserved.
Install
npm install nizel-plugin-emoji
Usage
import { useNizel } from 'nizel';
import { emojiPlugin } from 'nizel-plugin-emoji';
const nizel = useNizel({
plugins: [emojiPlugin()],
});
const text = await nizel.text('Ship it :rocket:');
Preview
Ship it 🚀 with ✅ status.
Built-In Shortcuts
Common shortcuts include:
:smile::heart::thumbsup::fire::rocket::check::warning::tada:
Unknown shortcuts are left unchanged.
Options
| Option | Type | Default | Description |
|---|---|---|---|
emojiMap | Record<string, string> | Built-in map | Custom shortcuts merged over the built-in map. |
Custom Shortcuts
const nizel = useNizel({
plugins: [
emojiPlugin({
emojiMap: {
ship: '🚢',
},
}),
],
});
Plugins
More Pages
-
Alerts
nizel-plugin-alertadds GitHub-style callout blocks for notes, tips, important notices, warnings, and cautions. -
Autolinks
nizel-plugin-autolinkconfigures Nizel's built-in conversion of bare URLs and email addresses into links. -
Code Copy
nizel-plugin-code-copyrenders copy controls for fenced code blocks. -
Definition Lists
nizel-plugin-deflistconverts definition-list syntax into<dl>,<dt>, and<dd>output. -
Shiki
nizel-plugin-shikilets Nizel delegate fenced code block rendering to a Worker-compatible highlighter function. -
Task Lists
nizel-plugin-task-listrenders parsed task-list items as checkbox markup. -
Abbreviations
nizel-plugin-abbrrenders abbreviation definitions such as: -
Badge
nizel-plugin-badgerenders compact inline labels with safe tones, aliases, titles, and metadata. -
Citations
nizel-plugin-citationsadds simple citation references and bibliography output. -
Details
nizel-plugin-detailsadds disclosure blocks: -
Diagrams
nizel-plugin-diagramsrenders Mermaid fences as containers for a host Mermaid renderer. -
Footnotes
nizel-plugin-footnotesrenders[^id]references and definitions. -
Frontmatter UI
nizel-plugin-frontmatter-uiprovides helpers for rendering metadata as UI. Core Nizel already parses frontmatter; this plugin is for display. -
GFM Preset
nizel-plugin-gfmis a convenience preset for GFM-oriented companion plugins. Core Nizel already includes GFM-like tables, task list metadata, strikethrough, and autolinks. -
Heading Anchors
nizel-plugin-heading-anchorsappends visible anchor links to headings with generated IDs. -
Hidden Comments
nizel-plugin-hidden-commentscontrols how Markdown HTML comments render. It can keep comments in the generated HTML for copy/PDF workflows, show them as small reviewer notes, render them inline, or remove them entirely. -
Keyboard Shortcuts
nizel-plugin-kbdrenders inline keyboard shortcuts as real<kbd>elements. -
Math
nizel-plugin-mathwraps inline$math$and display$$math for a host renderer such as KaTeX or MathJax. -
Media
nizel-plugin-mediaenhances standalone images by wrapping them in figures and adding native-friendly image attributes. -
Open Icon
nizel-plugin-open-iconrenders Open Icon SVGs from the installedopen-iconpackage. -
Print
nizel-plugin-printadds block directives for page breaks, print-only content, screen-only content, and page split control. -
Sanitize
nizel-plugin-sanitizeremoves risky HTML from rendered output. It is enabled by default innizel-kit. -
Table of Contents
nizel-plugin-tocrenders[[toc]]from document headings. -
Typography
nizel-plugin-typographyadds optional inline typography extensions: