Isamu Takeda

<p>This block has the function of editing Markdown documents using SimpleMDE, and by parsing Markdown documents using marked, it can assign specific blocks to the converted HTML elements.<br />
This function allows users to customize Markdown documents using the styling functions of the corresponding blocks, allowing for a wide range of styling.<br />
The following are the blocks that are applied when Markdown documents are parsed into HTML elements.</p>
<ol>
<li>H element: itmar/design-title</li>
<li>P element: core/paragraph</li>
<li>PRE element: itmar/code-highlight</li>
<li>IMG element: core/image</li>
<li>BLOCKQUOTE element: core/quote</li>
<li>LI element: core/list</li>
<li>TABLE element: core/table</li>
</ol>
<p>The H element is also generated as a table of contents, and has the function of displaying nested items according to level.<br />
This plugin does not require any external resources (all scripts and styles are included locally)</p>
<h3>Related Links</h3>
<ul>
<li><a href="https://github.com/itmaroon/markdown-block" rel="nofollow ugc">markdown-block:Github</a></li>
<li><a href="https://github.com/itmaroon/block-class-package" rel="nofollow ugc">block-class-package:GitHub</a>  </li>
<li><a href="https://packagist.org/packages/itmar/block-class-package" rel="nofollow ugc">block-class-package:Packagist</a> </li>
<li><a href="https://www.npmjs.com/package/itmar-block-packages" rel="nofollow ugc">itmar-block-packages:npm</a>  </li>
<li><a href="https://github.com/itmaroon/itmar-block-packages" rel="nofollow ugc">itmar-block-packages:GitHub</a></li>
</ul>
<h3>Arbitrary section</h3>
<ol>
<li>
<p>PHP class management is now done using Composer.<br />
<a href="https://github.com/itmaroon/block-class-package" rel="nofollow ugc">GitHub</a><br />
<a href="https://packagist.org/packages/itmar/block-class-package" rel="nofollow ugc">Packagist</a></p>
</li>
<li>
<p>I decided to make functions and components common to other plugins into npm packages, and install and use them from npm.<br />
<a href="https://www.npmjs.com/package/itmar-block-packages" rel="nofollow ugc">npm</a><br />
<a href="https://github.com/itmaroon/itmar-block-packages" rel="nofollow ugc">GitHub</a></p>
</li>
</ol>
<h3>External services</h3>
<ol>
<li>This plugin uses EasyMDE to implement the editing function of Markdown documents. This is an open source JavaScript library provided under the MIT license.<br />
<a href="https://github.com/Ionaru/easy-markdown-editor/blob/master/LICENSE" rel="nofollow ugc">EasyMDE LICENSE</a><br />
EasyMDE comes with a spell check feature.<br />
When using this feature, it will try to load an external file (en_US.aff / en_US.dic) from a CDN. To avoid this, this plugin sets spellChecker: false, when instantiating EasyMDE, so that the external file will not be loaded.</li>
<li>This plugin uses marked to parse Markdown documents and convert them to HTML elements. This is an open source JavaScript library provided under the MIT license.<br />
<a href="https://github.com/markedjs/marked/blob/master/LICENSE.md" rel="nofollow ugc">marked LICENSE</a></li>
</ol>


MarkDown Block

This block converts Markdown documents into blocks for styling web pages.

pReya

<p>This is a plugin for WordPress to embed Markdown files from external web sources (e.g. GitHub, GitLab, etc) into WordPress content using the shortcode <code>[external_markdown]</code>. A possible use case for this is to show content from a single source of truth (like a GitHub repository) on your WordPress website.</p>
<h3>Features</h3>
<ul>
<li>Embed any publicly accessible markdown file from other websites</li>
<li>Uses the public and free <a href="https://docs.github.com/en/rest/reference/markdown" rel="nofollow ugc">GitHub API</a> to transform Markdown to HTML (there is a rate limit – so don’t overdo it)</li>
<li>Caching support (so you can configure how often the file is being fetched from the source – default is a <strong>once per hour</strong> maximum)</li>
<li>Customise the CSS class of the markdown container to adjust styles</li>
</ul>
<h3>Instructions / Examples</h3>
<p>Download and unpack or clone this repository into your <code>wp-content/plugins</code> folder, so the PHP file resides in <code>wp-content/plugins/external-markdown/external-markdown.php</code>.</p>
<p>If you use the Guttenberg editor, you need to add a “Shortcode” block first. If your’re using the classic editor, you can use the shortcode right away.</p>
<h4>Simple embed</h4>
<p>The <code>url</code> parameter takes the URL to the Markdown file you want to embed. Make sure to <a href="#attention-when-using-github-gitlab-etc" rel="nofollow ugc">use the “raw” URL when you use GitHub, GitLab, etc</a>.<br />
    <code>[external_markdown url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]</code></p>
<h4>Adjust caching duration</h4>
<p>The <code>ttl</code> parameter controls how long the cached version is used, before it’s fetched again. The value is given in seconds. So 24 hours (24* 60 *60) result in a value of 86400.<br />
    <code>[external_markdown ttl=86400 url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]</code></p>
<h4>Adjust container CSS class</h4>
<p>The <code>class</code> parameter takes your desired class name for the external markdown container. The default class name for the container is <code>class='external-markdown'</code>.<br />
    <code>[external_markdown class="my-classname" url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]</code></p>
<h4>Attention when using GitHub, GitLab, etc.</h4>
<p>When embedding content from Git hosting services like GitHub or GitLab, you need to make sure to use the proper “raw” markdown URL. You can find this URL in the upper right corner of the web view.</p>
<h3>Attribution</h3>
<ul>
<li>This plugin was inspired by the great <a href="https://wordpress.org/plugins/documents-from-git/" rel="ugc">wordpress-markdown-git</a> plugin, which serves a similar purpose, but uses the Git provider APIs to fetch the raw Markdown files – which is a little more complicated than this approach here.</li>
</ul>


External Markdown

Working well

This is a plugin for Wordpress to embed Markdown files from external web sources (e.g. GitHub, GitLab, etc) into WordPress content.

MarkDown Block vs External Markdown