nibula 2.2.1 → 2.2.2

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to Nibula are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.2] - 2026-08-19
+
+### Fixed
+- The commented `renderFile` example in the page template now passes `"md"` as
+  the format argument. Without it Eleventy also ran the file through Nunjucks, so
+  a `.md` containing template syntax — a code sample with `{{ }}` or `{% %}` in
+  it — broke the build instead of rendering as text.
+
 ## [2.2.1] - 2026-08-18
 
 ### Fixed

package/docs/Components.md

@@ -13,8 +13,6 @@ src/frontend/components/
 ├── global/
 │   ├── header.njk
 │   └── footer.njk
-├── modals/
-│   └── privacyModal.njk
 ├── not-found.njk
 ├── welcome.njk
 ```
@@ -88,7 +86,7 @@ Open the page's file in `src/frontend/routes/` and add this line to its body:
 
 ```html
 <article class="markdown-body">
-    {% renderFile "article.md" | markdownPath, { site: site } %}
+    {% renderFile "article.md" | markdownPath, { site: site }, "md" %}
 </article>
 ```
 
@@ -100,6 +98,7 @@ Four parts to it:
 | `renderFile` | turns the Markdown into HTML and puts it in the page |
 | `markdownPath` | fills in the `src/frontend/components/` part of the path for you |
 | `{ site: site }` | hands the file your site settings — see below |
+| `"md"` | specifies that the rendering should be done as Markdown, ignoring the njk engine associated by default with the file extension |
 
 Subfolders work the same way as with components:
 `"legal/privacy.md" | markdownPath`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nibula",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "A beginner-friendly static site generator built on Eleventy that stays close to vanilla HTML, CSS and JS — with a page-management CLI, an optional PHP backend, and SEO files generated for you.",
   "keywords": [
     "11ty",

package/src/frontend/routes/404.njk

@@ -10,6 +10,6 @@ layout: base.njk
 {# Markdown files live in components/ too. Pass the data the file needs #}
 {#
 <article class="markdown-body">
-    {% renderFile "your-file.md" | markdownPath, { site: site } %}
+    {% renderFile "your-file.md" | markdownPath, { site: site }, "md" %}
 </article>
 #}

package/src/frontend/routes/index.njk

@@ -10,6 +10,6 @@ layout: base.njk
 {# Markdown files live in components/ too. Pass the data the file needs #}
 {#
 <article class="markdown-body">
-    {% renderFile "your-file.md" | markdownPath, { site: site } %}
+    {% renderFile "your-file.md" | markdownPath, { site: site }, "md" %}
 </article>
 #}

package/tools/res/templates/template.njk

@@ -10,6 +10,6 @@ layout: base.njk
 {# Markdown files live in components/ too. Pass the data the file needs #}
 {# 
 <article class="markdown-body">
-    {% renderFile "your-file.md" | markdownPath, { site: site } %}
+    {% renderFile "your-file.md" | markdownPath, { site: site }, "md" %}
 </article>
 #}