{"id":3423,"date":"2026-05-06T10:34:36","date_gmt":"2026-05-06T08:34:36","guid":{"rendered":"https:\/\/digitalia.culturanuova.net\/blog\/?p=3423"},"modified":"2026-06-06T09:46:22","modified_gmt":"2026-06-06T07:46:22","slug":"external-markdown-file-in-wordpress","status":"publish","type":"post","link":"https:\/\/digitalia.culturanuova.net\/blog\/?p=3423","title":{"rendered":"External markdown file in WordPress"},"content":{"rendered":"\n<p>If you want keep an external markdown file and include it in a WordPress page, you can follow these steps:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>add a js file, such as md-block.js,  in your js theme folder (typically \/wp-content\/themes\/your-theme\/js\/ )<\/li>\n\n\n\n<li>modify the functions.php file, in your root theme folder,. adding this code:<br><\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>\/\/ per markdown BEGIN\n\nfunction carica_md_block() {\n    wp_enqueue_script(\n        'md-block',\n        get_stylesheet_directory_uri() . '\/js\/md-block.js',\n        array(),\n        null,\n        true\n    );\n}\nadd_action('wp_enqueue_scripts', 'carica_md_block');\n\nadd_filter('script_loader_tag', function($tag, $handle, $src) {\n    if ($handle === 'md-block') {\n        return '&lt;script type=\"module\" src=\"' . esc_url($src) . '\"&gt;&lt;\/script&gt;';\n    }\n    return $tag;\n}, 10, 3);\n\nfunction shortcode_scheda_md($atts) {\n    $atts = shortcode_atts(array(\n        'file' =&gt; ''\n    ), $atts);\n\n    $file = basename($atts&#91;'file']);\n\n    if (empty($file) || pathinfo($file, PATHINFO_EXTENSION) !== 'md') {\n        return '';\n    }\n\n    $url = content_url('\/uploads\/some-path\/' . rawurlencode($file));\n\n    return '&lt;md-block src=\"' . esc_url($url) . '\"&gt;&lt;\/md-block&gt;';\n}\nadd_shortcode('scheda_md', 'shortcode_scheda_md');\n\n\/\/ per markdown END<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>you can put your md files in the path above set:  <code>\/uploads\/some-path\/<\/code> . Note that the folder some-path could be a symlinked one, from your local PC.<\/li>\n\n\n\n<li>in the wordpress page when you want include a md file you can write, \n<ul class=\"wp-block-list\">\n<li>using HTML (customized), <code>[scheda_md file=\"the-name-of-the-file.md\"]<\/code>, <\/li>\n\n\n\n<li>or the code visualizaztion: something like<code>[scheda_md]the-name-of-the-file.md[\/scheda_md]<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>where that file, obviously, should be in <code>\/some-path\/<\/code> folder.<\/li>\n<\/ul>\n\n\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you want keep an external markdown file and include it in a WordPress page, you can follow these steps:<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":"[]"},"categories":[747,828,829,565,751,566],"tags":[488],"class_list":["post-3423","post","type-post","status-publish","format-standard","hentry","category-javascript","category-markdown","category-markdown-office","category-office","category-php","category-webmaster","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3423","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3423"}],"version-history":[{"count":4,"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3423\/revisions"}],"predecessor-version":[{"id":3471,"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3423\/revisions\/3471"}],"wp:attachment":[{"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3423"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3423"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/digitalia.culturanuova.net\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3423"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}