match[yes]]">
{{$:/plugins/tiddlywiki/markdown/images/new-markdown-button}}
$list>
diff --git a/plugins/tiddlywiki/markdown/plugin.info b/plugins/tiddlywiki/markdown/plugin.info
index e9db61d7e..ffe74fb03 100755
--- a/plugins/tiddlywiki/markdown/plugin.info
+++ b/plugins/tiddlywiki/markdown/plugin.info
@@ -1,6 +1,6 @@
{
"title": "$:/plugins/tiddlywiki/markdown",
"name": "Markdown",
- "description": "Markdown parser based on remarkable by Jon Schlinkert and remarkable-katex by Brad Howes",
- "list": "readme usage remarkable-license remarkable-katex-license"
+ "description": "Markdown parser based on markdown-it",
+ "list": "readme config syntax license"
}
diff --git a/plugins/tiddlywiki/markdown/readme.tid b/plugins/tiddlywiki/markdown/readme.tid
index dd5dd0666..1859fd36e 100755
--- a/plugins/tiddlywiki/markdown/readme.tid
+++ b/plugins/tiddlywiki/markdown/readme.tid
@@ -1,7 +1,32 @@
title: $:/plugins/tiddlywiki/markdown/readme
-This is a TiddlyWiki plugin for parsing Markdown text, using the [[Remarkable|https://github.com/jonschlinkert/remarkable]] library. If the KaTeX TiddlyWiki plugin is installed, KaTeX support is enabled using the [[remarkable-katex|https://github.com/bradhowes/remarkable-katex]] Remarkable plugin.
+This plugin provides Markdown support via the [[markdown-it|https://github.com/markdown-it/markdown-it]] parser and its associated plugins:
-It is completely self-contained, and doesn't need an Internet connection in order to work. It works both in the browser and under Node.js.
+* markdown-it-deflist
+* markdown-it-footnote
+* markdown-it-ins
+* markdown-it-mark
+* markdown-it-sub
+* markdown-it-sup
-[[Source code|https://github.com/Jermolene/TiddlyWiki5/blob/master/plugins/tiddlywiki/markdown]]
+!! Compatibility Notes
+
+* A tab character in Markdown has a size of four spaces. Configure the tab size of your code editor accordingly. For example, if you use <$text text="CodeMirror"/>, it is recommended that you set $:/config/codemirror/indentUnit and $:/config/codemirror/tabSize to `4` to avoid inconsistent indentations.
+* HTML blocks are ultimately parsed by the <$text text=WikiText/> parser: //an opening tag followed by a blank line will activate block-level parsing for its content//. When working with tags designed to contain literal content, such as `
` and `