Just discovered how easy it is to add a simple TOC 📋 to your #Markdown #Jekyll 🧪 website 🙈 Simply add these two lines of code to your Markdown file (using the #MinimalMistakes theme + #kramdown):

* TOC
{:toc .toc_intext}

and add some appropriate #CSS commands to your _base.scss. That's it, no further plugins are requiered. See it in action here: 🌍 https://www.fabriziomusacchio.com/blog/2024-01-08-ruhrmuseum/

#webdesign #FOSS

The Ruhr Museum: A Journey through the cultural heritage of the Ruhrgebiet

During a recent visit to the Ruhr Museum in Essen, I discovered not just an outstanding modern museum, but also a gateway to the rich history of the Ruhr area, also known as the ‘Ruhrpott’. This museum visit opened my eyes to the depth and complexity of the Ruhr region’s past and present.

Fabrizio Musacchio
Wrote a step-by-step blog post on how to add a man page to a Ruby project using kramdown-man.
https://postmodern.github.io/blog/2023/12/05/how-to-add-a-man-page-to-your-ruby-project.html
#ruby #markdown #manpage #kramdown #cli
postmodern - how to add a man page to your ruby project

🌘 GitHub - postmodern/kramdown-man: 將Markdown文件轉換為man頁面的Kramdown轉換工具
➤ Kramdown轉換工具
https://github.com/postmodern/kramdown-man
這是一個將Markdown文件轉換為man頁面的Kramdown轉換工具,支援多種格式、連結和代碼塊等功能。
+ 這個工具對於需要將Markdown文件轉換為man頁面的開發者來說非常實用。
+ 非常方便的工具,能夠將Markdown文件轉換為易於閱讀的man頁面,省去了許多手動轉換的麻煩。
#GitHub #Kramdown #Markdown #man頁面
GitHub - postmodern/kramdown-man: Allows you to write man pages in pure markdown.

Allows you to write man pages in pure markdown. Contribute to postmodern/kramdown-man development by creating an account on GitHub.

GitHub
Release 1.0.0 · postmodern/kramdown-man

Ignore kd:blank elements to reduce size of generated man pages. No longer output .HP paragraphs due to cross-platform compatibility issues with groff, nroff, troff. Renamed Kramdown::Converters::Ma...

GitHub
Atleast kramdown supports *foo*{:.underline}, but ugh that syntax is _cumbersome_.
https://kramdown.gettalong.org/syntax.html#span-ials
#markdown #kramdown
Syntax | kramdown

kramdown is a fast, pure-Ruby Markdown-superset converter

@adamghill whew, for a split second, when I saw a link rather than a recommendation for something like #PanDoc or #Kramdown, I feared you were suggesting that a sane person would use some third party web site or service to generate HTML from #Markdown source. Then after a few more milliseconds my brain recognized the Github domain and I calmed down enough to browse the link and verify that https://github.com/lepture/mistune is a Python library and regained my composure 😏
GitHub - lepture/mistune: A fast yet powerful Python Markdown parser with renderers and plugins.

A fast yet powerful Python Markdown parser with renderers and plugins. - lepture/mistune

GitHub

How is it that in 2023 there is no #Kramdown plug in for #VSC (Visual Studio Code)??
Does no one other than me use github.io for their project doc's??

On my page I have a clear statement that 'I don't know what I am doing'... this yet again, seems to prove that I have made a bad decision to use #github for my project??

Mermaid 🧜‍♀️, kramdown und der Schockwellenreiter

Weil ich gerade sowieso wegen P5.js an den Quellen des Schockwellenreiters herumschraubte, wollte ich auch gleich noch Mermaid in dieses Blog Kritzelheft integrieren. Ich dachte mir »JavaScript ist JavaScript«, so schwer kann das doch nicht sein. Ganz so einfach war es aber leider nicht, aber mit diesen Schritten habe ich es dann doch noch hinbekommen: http://blog.schockwellenreiter.de/2022/05/2022050802.html #Mermaid #kramdown #Markdown

Mermaid 🧜‍♀️, kramdown und der Schockwellenreiter – Schockwellenreiter

Nachmittagsprogramm: #Jekyll, & #Kramdown.

Security Alert: Kramdown!

#Kramdown ist ja bekanntlich der (Ruby-) Markdown-Interpreter, der auch in #RubyFrontier werkelt, dem Static Site Generator (SSG), der unter anderem auch dieses Blog und mein Wiki antreibt. Aber nicht nur dort, sondern zum Beispiel auch in #Jekyll (und damit auch im #CollectionBuilder) wird er gerne eingesetzt. Und nun erreichte mich ein #Security Alert (CVE-2021-28834) für Kramdown (genauer für den per Default aktiven Synatx-Highlighter Rouge): http://blog.schockwellenreiter.de/2021/03/2021033001.html

Security Alert: Kramdown! – Schockwellenreiter