Add markdown inspired comments to posts that render only within the block editor.
I honestly enjoy drafting articles either locally in Ulysses, or on my blog using the Iceberg Editor. 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.
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.
Learn more about Markdown Comment →
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.
I added a couple transforms, to and from headings and paragraphs, and a raw shortcut when you type %%
and hit the [space] key. This lets me quickly add comments, and even convert whole paragraphs or headings to a comment.
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.
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 can change the color of the comment — there are no other typographic controls.
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.
markdown-comment-block
folder to your /wp-content/plugins/
directory or alternatively upload the markdown-comment-block.zip file via the plugin page of WordPress by clicking ‘Add New’ and selecting the zip from your local computer.Yes! If you’re using Gutenberg (i.e. the block editor) on your site, you should have no issues with the block. It’s relatively simple to modify the CSS variables to tweak the comment styling if you’d like — learn more here.
Please reach out via the official plugin support forum.
As a WordPress entrepreneur, designer and developer all wrapped up in one, @richard_tabor is recognized as one of the top leaders in this post-Gutenberg era of WordPress. His design chops have topped the 2018 Automattic Design Awards and led him to found CoBlocks – a top-notch set of page builder blocks and tools for Gutenberg, ThemeBeans – a premier WordPress theme shop and Iceberg – a markdown editor for Gutenberg.