Djot markup language support for WordPress. A modern, cleaner alternative to Markdown.
Djot Markup adds support for the Djot markup language in WordPress. Djot is created by John MacFarlane (creator of CommonMark and Pandoc) and offers cleaner syntax with more consistent parsing rules than Markdown.
Features
- Full Djot Support: Headings, emphasis, links, images, code blocks, tables, footnotes, and more
- Shortcode Support: Use
[djot]...[/djot] in your content
- Content Filtering: Automatically process
{djot}...{/djot} blocks
- Table of Contents: Automatic TOC generation from headings with configurable levels and position
- Safe Mode: XSS protection for untrusted content
- Syntax Highlighting: Server-side highlighting with Torchlight Engine
- Admin Settings: Easy configuration through WordPress admin
- Template Tags: Functions for theme developers
- Dark Mode Support: CSS adapts to dark mode preferences
Usage
Shortcode:
[djot]
# Hello World
This is _emphasized_ and this is *strong*.
- List item 1
- List item 2
[/djot]
Template Tags:
<?php
$html = wpdjot_to_html('# Hello *World*!');
wpdjot_the('# _Hello_ *World*!');
?>
Links
FAQ
What is Djot?
Djot is a light markup syntax created by John MacFarlane, the creator of CommonMark and Pandoc. It’s designed to be a cleaner, more consistent alternative to Markdown.
Why use Djot instead of Markdown?
Djot has cleaner syntax rules, proper footnote support, attributes for styling, and avoids many of Markdown’s parsing ambiguities.
ChangeLog
1.5.7
- Added experimental visual editor (WYSIWYG) for Djot blocks powered by Tiptap
- Added Experimental settings section with visual editor mode options
- Fixed visual editor round-trip preservation for all Djot elements
- Fixed different list types (bullet/ordered/task) colliding without blank lines
1.5.6
- Fixed task list checkboxes stripped by wp_kses_post
- Fixed dark mode TOC text color
1.5.5
- Added Djot syntax highlighting for code blocks via djot-grammars
- Fixed code block filename markers leaking into output
- Updated php-collective/djot to 0.1.17
1.5.4
- Fixed Torchlight line highlighting CSS selectors for annotated lines
- Removed opinionated visual styling (blockquotes, links, tables, etc.) – let themes handle it
1.5.3
- Fixed PHP 8.2 trait constants compatibility (Rector downgrade)
1.5.2
- Fixed PHP 8.0 downgrade for WordPress.org compatibility
1.5.1
- Fixed deployment: remove missing dev dependencies from distribution
1.5.0
- Added Torchlight Engine integration for advanced code block features
- Added inline code annotations: highlight, focus, diff (+/-), and ranges
- Added Code Annotations panel in block editor sidebar
- Replaced highlight.js with server-side Torchlight/Phiki
1.4.3
- Fixed vertical spacing in highlighted code blocks
1.4.2
- Added code block line numbers and line highlighting syntax
- Fixed legacy wp-djot/djot blocks editability in Gutenberg
1.4.1
- Fixed Table of Contents and heading permalinks appearing in post excerpts on archive pages
1.4.0
- Added automatic Table of Contents generation from headings
- Configurable TOC position (top/bottom), heading levels, and list type
- Light and dark mode styling for TOC
- Added heading permalinks with show-on-hover and copy-to-clipboard
- Added locale-aware smart quotes (20 locales + Auto from site language)
- Bumped php-collective/djot to ^0.1.13
1.3.1
- Fixed text domain to match plugin slug (djot-markup)
- Properly escape HTML output with wp_kses_post/wp_kses
- Fixed block wrapper attributes escaping for Plugin Check compliance
- Excluded non-permitted files from distribution
- Added build script for distribution zip
- Added markmarkmark to Contributors list
1.2.1
- Renamed plugin to “Djot Markup” for WordPress.org compliance
- Added ABSPATH checks to all PHP files for security
- Prefixed global variables for WordPress coding standards compliance
1.2.0
- Changed code prefix from wp_djot/wp-djot to wpdjot for WordPress.org compliance
- Updated highlight.js from v11.9.0 to v11.11.1
- Added backward compatibility for existing blocks and settings
- Added settings migration from old option name
1.1.0
- Comment formatting toolbar with buttons for Bold, Italic, Code, Link, Quote, and Code Block
- Write/Preview tabs for comment toolbar with live Djot preview
- Syntax highlighting in comment preview
- Excerpt filter to render Djot content on archive pages
- Support for extracting Djot content from Gutenberg blocks for excerpts
- Fixed archive pages to properly show excerpts with “Read more” links
1.0.0
- Initial release
- Full Djot syntax support
- Shortcode and content filtering
- Admin settings page
- Syntax highlighting with highlight.js
- Safe mode for untrusted content
- Template tags for theme developers
