Rich Tabor

<h3>Comments that only render in the block editor</h3>
<p>I honestly enjoy drafting articles either locally in Ulysses, or on <a href="https://richtabor.com" rel="nofollow ugc">my blog</a> using the <a href="https://useiceberg.com/?utm_source=wp-org&utm_medium=markdown-comment-block&utm_campaign=readme-description" rel="nofollow ugc">Iceberg Editor</a>. While I do love Iceberg, once I publish an article I typically bring back the default Gutenberg experience — thus removing any comments I previously added.</p>
<p>Having the ability to add, and keep, any relevant editing comments within my posts, without rendering them on the front-end, means that I am freed up to mentally jot any idea down without thinking about it. It is simply natural and convenient.</p>
<p><a href="https://richtabor.com/markdown-comments/?utm_source=wp-org&utm_medium=markdown-comment-block&utm_campaign=readme-learnmore" rel="nofollow ugc">Learn more about Markdown Comment →</a></p>
<h3>What’s interesting about Markdown Comment:</h3>
<h4>1. Editor only</h4>
<p>The block only renders within the editor. For developers reading this, that means there’s no save function. I don’t want my unfinished ideas, reminders, and notes rendered within my post – even if they’re hidden by CSS.</p>
<h4>2. Helpful block transforms</h4>
<p>I added a couple transforms, to and from headings and paragraphs, and a raw shortcut when you type <code>%%</code> and hit the [space] key. This lets me quickly add comments, and even convert whole paragraphs or headings to a comment.</p>
<h4>3. Easily resolve comments</h4>
<p>To support that path towards simplicity, I wanted a method to quickly resolve — i.e. banish — a comment entirely. So, I added a toolbar control to quickly resolve the comment, removing the block entirely.</p>
<h4>4. No rich text support</h4>
<p>Comments need to have minimal impact on editing, and feel as natural as possible. That’s why there are no typical RichText controls (although you can still bold, italicize and add hyperlinks). And while you <em>can</em> change the color of the comment — there are no other typographic controls.</p>
<h4>5. Entirely CSS Variable ready</h4>
<p>Global styles and full site editing are opening the door for themes to be heavily powered by CSS variables. Blocks should be designed with that same mentality, which is exactly what I did here. I added simple CSS variables with fallbacks that are the default values. To further theme the comment, there’s no need to override any styles with classes, just write a few CSS variables.</p>


Markdown Comment Block

Add markdown inspired comments to posts that render only within the block editor.

rob1n

<p><strong>Got a bug report or want to contribute?</strong> Please do so on the <a href="https://github.com/robinadr/parsedown-wp/issues" rel="nofollow ugc">GitHub issue tracker</a> or <a href="https://github.com/robinadr/parsedown-wp/pulls" rel="nofollow ugc">submit a pull request</a>.</p>
<p><a href="http://parsedown.org" rel="nofollow ugc">Parsedown</a> is an efficient, modern PHP implementation of the <a href="http://daringfireball.net/projects/markdown/" rel="nofollow ugc">Markdown</a> syntax originally developed by John Gruber. This plugin runs your posts and comments through the <a href="https://github.com/erusev/parsedown-extra" rel="nofollow ugc">Parsedown Extra</a> version, which has additional features that are part of the <a href="https://michelf.ca/projects/php-markdown/extra/" rel="nofollow ugc">Markdown Extra</a> extension by Michel Fortin.</p>
<p>Michel wrote the <a href="https://michelf.ca/projects/php-markdown/classic/" rel="nofollow ugc">original Markdown plugin for WordPress</a>, and this aims to be a 100% compatible drop-in replacement for that. Michel’s original plugin is no longer supported as of February 1, 2014.</p>
<p>So <strong>why Parsedown?</strong> It’s <a href="http://parsedown.org/speed" rel="nofollow ugc">faster</a>, <a href="http://parsedown.org/consistency" rel="nofollow ugc">more consistent</a> and is being <a href="https://github.com/erusev/parsedown" rel="nofollow ugc">actively developed</a>.</p>
<p>Development of this WordPress plugin <a href="https://github.com/robinadr/parsedown-wp" rel="nofollow ugc">takes place over on GitHub</a>. If you have any support requests, I do monitor the support forums on here, or you can <a href="http://robinadr.com/contact" rel="nofollow ugc">contact me directly</a>.</p>


Parsedown for WordPress

I really love Parsedown, I created a web app with it recently to host Markdown files on my server. I was really impressed with Parsedown's speed. This plugin is exactly what I was looking for, so I could store my posts as Markdown in WordPress yet display them as HTML on the front-end.

Love this plugin

This plugin processes your posts and comments using the Parsedown library. It is a direct replacement for PHP Markdown Extra by Michel Fortin.

Markdown Comment Block vs Parsedown for WordPress