{"id":26118,"date":"2022-11-19T18:16:19","date_gmt":"2022-11-19T17:16:19","guid":{"rendered":"https:\/\/ekiwi-blog.de\/?p=26118"},"modified":"2022-12-17T20:02:31","modified_gmt":"2022-12-17T19:02:31","slug":"jekyll-does-not-generate-html-file-from-markdown-file-md-file","status":"publish","type":"post","link":"https:\/\/ekiwi-blog.de\/en\/26118\/jekyll-does-not-generate-html-file-from-markdown-file-md-file\/","title":{"rendered":"Jekyll does not generate html file from markdown file (md file)"},"content":{"rendered":"<p><a href=\"https:\/\/jekyllrb.com\/\" target=\"_blank\" rel=\"noopener\">Jekyll<\/a> is an interesting application to create static web pages from Markdown files. The simplified Markdown syntax also makes it easy to add new content quickly.<\/p>\n<p>With the command<\/p>\n<blockquote><p><code>bundle exec jekyll serve<\/code><\/p><\/blockquote>\n<p>you can create <abbr title=\"Hypertext Markup Language\">html<\/abbr>-files from <abbr title=\"Markdown\">md<\/abbr>-files under Linux\/Ubuntu.<\/p>\n<p>I encountered the problem that all markdown files were converted to <a title=\"HTML: Indent or tab text\" href=\"https:\/\/ekiwi.de\/en\/index.php\/4697\/html-indent-or-tab-text\/\" target=\"_blank\" rel=\"noopener\">html<\/a> files, except one md file. No html file was created from a markdown file. The markdown file was only copied to the output directory <em><strong>_site<\/strong><\/em>.<\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_82_2 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of content<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/ekiwi-blog.de\/en\/26118\/jekyll-does-not-generate-html-file-from-markdown-file-md-file\/#Solution\" >Solution<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/ekiwi-blog.de\/en\/26118\/jekyll-does-not-generate-html-file-from-markdown-file-md-file\/#Compare_Front_Matter_with_other_md_files\" >Compare Front Matter with other md files<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/ekiwi-blog.de\/en\/26118\/jekyll-does-not-generate-html-file-from-markdown-file-md-file\/#Check_encoding\" >Check encoding<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Solution\"><\/span>Solution<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<h3><span class=\"ez-toc-section\" id=\"Compare_Front_Matter_with_other_md_files\"><\/span>Compare Front Matter with other md files<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>This indicates that Jekyll treats the file as a static file and just copies it.<\/p>\n<p>One reason for this may be that the so-called <a href=\"https:\/\/jekyllrb.com\/docs\/front-matter\/\" target=\"_blank\" rel=\"noopener\">Font Matter<\/a> is missing or incorrect.<\/p>\n<figure id=\"attachment_26117\" aria-describedby=\"caption-attachment-26117\" style=\"width: 583px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-26117 size-full\" title=\"Jekyll: HTML file is not created from markdown file (md-file)\" src=\"https:\/\/ekiwi-blog.de\/wp-content\/uploads\/2022\/11\/jekyll-front-matter.jpg\" alt=\"Screenshot Jekyll Front Matter in Markdown-File\" width=\"583\" height=\"213\" srcset=\"https:\/\/ekiwi-blog.de\/wp-content\/uploads\/2022\/11\/jekyll-front-matter.jpg 583w, https:\/\/ekiwi-blog.de\/wp-content\/uploads\/2022\/11\/jekyll-front-matter-300x110.jpg 300w\" sizes=\"auto, (max-width: 583px) 100vw, 583px\" \/><figcaption id=\"caption-attachment-26117\" class=\"wp-caption-text\">Jekyll Front Matter in md-file<\/figcaption><\/figure>\n<p>In the <em>Front Matter<\/em> the reference to the <em>layout<\/em>, the definition of the <em>title<\/em> and other details are made.<\/p>\n<p>But a comparison of the Front Matter with the other md-files that are correctly converted from Markdown to html has shown that there is no noticeable difference.<\/p>\n<h3><span class=\"ez-toc-section\" id=\"Check_encoding\"><\/span>Check encoding<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Now you can check if there are differences in the encoding of the respective file. You can check the encoding with a text editor like <a href=\"https:\/\/www.sublimetext.com\/\" target=\"_blank\" rel=\"noopener\">Sublime<\/a>.<\/p>\n<p>In my case it turned out that the md-file in question, which is not converted into an html-file, has the encoding <em>UTF-8 with BOM<\/em>.<\/p>\n<figure id=\"attachment_26115\" aria-describedby=\"caption-attachment-26115\" style=\"width: 599px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-26115 size-full\" title=\"jekyll: markdown file is not converted\/exported to html file\" src=\"https:\/\/ekiwi-blog.de\/wp-content\/uploads\/2022\/11\/encoding-of-file-uft8-bom.jpg\" alt=\"Screenshot showing encoding in text-editor\" width=\"599\" height=\"346\" srcset=\"https:\/\/ekiwi-blog.de\/wp-content\/uploads\/2022\/11\/encoding-of-file-uft8-bom.jpg 599w, https:\/\/ekiwi-blog.de\/wp-content\/uploads\/2022\/11\/encoding-of-file-uft8-bom-300x173.jpg 300w\" sizes=\"auto, (max-width: 599px) 100vw, 599px\" \/><figcaption id=\"caption-attachment-26115\" class=\"wp-caption-text\">encoding UTF-8 with BOM shown in texteditor sublime<\/figcaption><\/figure>\n<p>If you now <a href=\"https:\/\/ekiwi-blog.de\/en\/50316\/vba-excel-macro-save-spreadsheet-as-csv-file\/\" title=\"VBA Excel Macro: Save spreadsheet as CSV file\">save the file<\/a> with the encoding UTF-8 (<u>without BOM), the md file in question is also correctly generated as an HTML-file in the output directory <strong>_site<\/strong>.<\/p>","protected":false},"excerpt":{"rendered":"<p>Jekyll is an interesting application to create static web pages from Markdown files. The simplified Markdown syntax also makes it<\/p>\n","protected":false},"author":2,"featured_media":24371,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1555],"tags":[2175,2165,2442,2441,2171,2174],"class_list":["post-26118","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-software-en","tag-homepage-en","tag-html-en","tag-jekyll-en","tag-markdown-en","tag-webseite-en","tag-website-en"],"_links":{"self":[{"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/posts\/26118","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/comments?post=26118"}],"version-history":[{"count":0,"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/posts\/26118\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/media\/24371"}],"wp:attachment":[{"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/media?parent=26118"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/categories?post=26118"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ekiwi-blog.de\/en\/wp-json\/wp\/v2\/tags?post=26118"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}