Merge pull request #61 from emil0r/publication/mermaid

post for mermaid.js

Author: timothypratley

deps.edn

@@ -14,6 +14,7 @@
   org.scicloj/clay                            {:mvn/version "2-beta53"
                                                #_#_:git/url "https://github.com/scicloj/clay.git"
                                                #_#_:git/sha "b5ebd1a98d7deba6c165a72077ffa08554f4c93a"}
+  org.scicloj/kindly                          {:mvn/version "4-beta19"}
   org.eclipse.elk/org.eclipse.elk.core        {:mvn/version "0.10.0"}
   org.eclipse.elk/org.eclipse.elk.graph       {:mvn/version "0.10.0"}
   org.eclipse.elk/org.eclipse.elk.graph.json  {:mvn/version "0.10.0"}

site/db.edn

@@ -87,7 +87,12 @@
    :image       "https://avatars.githubusercontent.com/u/4629681?v=4"
    :email       ""
    :affiliation [:scicloj]
-   :links       [{:icon "github" :href "https://github.com/joinr"}]}]
+   :links       [{:icon "github" :href "https://github.com/joinr"}]}
+  {:id          :emilbengtsson
+   :name        "Emil Bengtsson"
+   :url         "https://emil0r.com"
+   :image       "https://avatars.githubusercontent.com/u/49733?v=4"
+   :links       [{:icon "github" :href "https://github.com/emil0r"}]}]
 
  :affiliation
  [{:id   :clojure.core

src/scicloj/clay/mermaid.clj

@@ -0,0 +1,30 @@
+^{:kindly/hide-code true
+  :clay             {:title  "Mermaid.js"
+                     :format [:quarto :html]
+                     :quarto {:author      :emilbengtsson
+                              :description "Explain complex concepts with mermaid.js"
+                              :type        :post
+                              :date        "2025-09-05"
+                              :image       "mermaid.png"
+                              :category    :clay
+                              :tags        [:clay :workflow]}}}
+(ns scicloj.clay.mermaid
+  (:require [scicloj.kindly.v4.kind :as kind]))
+
+
+;; ## A picture is worth a thousand words
+
+(kind/mermaid "flowchart LR
+ Concept --> easy{Easy to understand?}
+ easy -->|Yes| Understanding
+ easy -->|No| Diagram
+ easy -->|No| wall(Wall of text)
+ Diagram --> Understanding
+ wall -->|Didn't get it| Concept
+ wall -->|Finally| Understanding")
+
+;;
+;; With [mermaid.js](https://mermaid.js.org/) you can now use words to generate
+;; a picture. One of the trickier aspects in explaining complex ideas/concepts,
+;; is the infliction point where words start to pile up towards dizzying heights
+;; and you lose sight of what what you wanted to communicate.