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.

DAEXT

<p>Ultimate Markdown is a plugin for WordPress that allows you to create WordPress posts with the popular Markdown syntax.</p>
<p>Specifically, after installing the plugin, you will be able to:</p>
<ul>
<li>Create posts with perfectly formatted blocks from existing Markdown files or Markdown documents created with the plugin.</li>
<li>Instantly generate blocks from Markdown text.</li>
<li>Create and manage an unlimited number of Markdown documents in a dedicated plugin menu.</li>
<li>Import Markdown file in WordPress.</li>
<li>Create archives of Markdown files from the Markdown documents created with the plugin.</li>
</ul>
<p>Please note that this plugin requires the use of the default <a href="https://wordpress.org/support/article/blocks/">WordPress Blocks Editor</a>. With third-party visual editors or with the <a href="https://wordpress.org/plugins/classic-editor/">Classic Editor</a>, you will not be able to use most of the plugin functionalities.</p>
<h3>Pro Version</h3>
<p>We distribute the <a href="https://daext.com/ultimate-markdown/" rel="nofollow ugc">Pro version</a> of this plugin that includes more export options, REST API, additional Markdown parsers, document categories, and more.</p>
<h3>Additional post sidebar sections</h3>
<p>The plugin adds the following sections to the post sidebar.</p>
<h4>Import Markdown</h4>
<p>This section allows you to generate the blocks of a post from an uploaded Markdown file.</p>
<h4>Load Markdown</h4>
<p>Use this feature to create the blocks of a post from a Markdown document previously created with the plugin.</p>
<h4>Submit Markdown</h4>
<p>With this section, you can instantly transform Markdown text to blocks.</p>
<h3>Dedicated plugin menus</h3>
<h4>Documents</h4>
<p>This menu includes a Markdown editor with an HTML preview section. In addition, you will find functionalities to create, edit, duplicate or delete your Markdown documents.</p>
<h4>Import</h4>
<p>Import one or more Markdown files in the plugin with the upload form provided in this menu.</p>
<h4>Export</h4>
<p>With this menu, you can generate Markdown files from the Markdown documents stored in the plugin.</p>
<h3>Supported Markdown syntax</h3>
<p>The conversion from Markdown text to HTML is performed with <a href="https://github.com/markedjs/marked" rel="nofollow ugc">Marked</a>, a high-performance Markdown parser that supports documents written in the following <a href="https://github.com/commonmark/commonmark-spec/wiki/Markdown-Flavors" rel="nofollow ugc">Markdown flavors</a>.</p>
<h3>Front Matter</h3>
<p>The plugin supports Front Matter key-value pairs provided in the <a href="https://yaml.org/" rel="nofollow ugc">YAML</a> language. With this feature, you can configure specific post settings by providing their values at the beginning of the Markdown document.</p>
<p>Please see the <a href="https://daext.com/doc/ultimate-markdown/" rel="nofollow ugc">plugin documentation</a> for more information on the available Front Matter keys and practical examples.</p>
<h3>Credits</h3>
<p>This plugin makes use of the following resources:</p>
<ul>
<li><a href="https://github.com/cure53/DOMPurify" rel="nofollow ugc">DOMPurify</a> licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0" rel="nofollow ugc">Apache License Version 2.0</a></li>
<li><a href="https://github.com/markedjs/marked" rel="nofollow ugc">Marked</a> licensed under the <a href="http://www.opensource.org/licenses/mit-license.php" rel="nofollow ugc">MIT License</a></li>
<li><a href="https://github.com/select2/select2" rel="nofollow ugc">Select2</a> licensed under the <a href="http://www.opensource.org/licenses/mit-license.php" rel="nofollow ugc">MIT License</a></li>
<li><a href="https://getcomposer.org/" rel="nofollow ugc">Composer</a> licensed under the <a href="http://www.opensource.org/licenses/mit-license.php" rel="nofollow ugc">MIT License</a></li>
<li><a href="https://github.com/thephpleague/html-to-markdown" rel="nofollow ugc">HTML To Markdown for PHP</a> licensed under the <a href="http://www.opensource.org/licenses/mit-license.php" rel="nofollow ugc">MIT License</a></li>
<li><a href="https://github.com/mnapoli/FrontYAML" rel="nofollow ugc">FrontYAML</a> licensed under the <a href="http://www.opensource.org/licenses/mit-license.php" rel="nofollow ugc">MIT License</a></li>
</ul>


Ultimate Markdown

Using Markdown with Gutenberg is quite difficult. Markdown block from Jetpack is very limited, plugins proposing to edit in Markdown in a separate editor miss blocks philosophy.
As I prefer to work with my favorite Markdown Editor, Ultimate Markdown is a nice solution : it can import Markdown text in the post and convert the different elements in the relative block. A text paragraph will be a block text, a list a block list and so on. So the result is a real Gutenberg content.

The downside : you cannot convert back to Markdown the post content but it’s not a big deal for me.

Interesting management of Markdown

Ultimate Markdown is a plugin for WordPress that allows you to create WordPress posts with…

Markdown Comment Block vs Ultimate Markdown