My Digital Garden

Welcome to my digital garden. This is a place where I can share my thoughts and notes on various topics. The notes are continuously updated and refined. Feel free to explore and learn something new.

What is a Digital Garden?

A digital garden is a mix between a notebook and a blog, it is a place to share thoughts and cultivate them into a garden. It also allows me to have a place where I can store my notes/summaries/tutorials for my studies.

The main difference to a blog is that a blog has articles and publication dates and never changes after it has been published, whereas a digital garden is a place where the written content can be continuously edited and refined. The notes are also very free flowing they can span from just a short cheat sheet to a full set of notes on an entire subject where you go into every nitty-gritty detail.

Another key difference is the navigation. A blog is usually read in chronological order but a digital garden can be read in any order you want and uses lots of internal links to connect all the notes into a Network (although this can be quite hard to diligently do).

If you are interested in learning more about digital gardens I can recommend the following article by Maggie Appleton .

How is my Garden Built?

The current iteration of my digital garden is built using Nextra . Nextra is a static site generator that is built on top of Next.js and MDX. This allows me to write my notes in markdown and also use the MDX format to write JSX in my markdown files. These markdown files are then converted into static HTML files using Next.js and can be hosted on any static site hosting service such as Vercel .

Features

In this section I briefly go over some of the features that are supported by my digital garden and how to use them.

Markdown

Markdown is supported out of the box. Anything that is supported by markdown can be used in the notes. This includes but is not limited to:

Headers
Lists
Links
Images
Code Blocks
Tables
Blockquotes

For a full list of markdown features check out the Markdown Guide .

MDX

In addition to the normal markdown format, Nextra also supports the MDX format which allows you to write JSX, i.e. react code in a markdown file. To find out more about MDX check out the official MDX documentation .

Admonitions / Callouts

Admonitions aren’t included in standard markdown but have become very popular. Recently GitHub has also added support for admonitions in markdown FileSystem, however they call them alerts.

Admonitions are very useful to highlight certain text and add a category to the text. I have added a custom component that builds on nextra’s callouts to be able to add custom callout types. To use callouts in a MDX file you can use the following syntax:


<Callout type="warning">
This Is a big scary warning.
</Callout>

Renders to:

Warning

This Is a big scary warning.

You can also change the title of the banner:


<Callout type="info" title="The following types are supported">
info, warning, error, example, todo
</Callout>

The following types are supported

info, warning, error, example, todo

The default callout type uses the websites primary color, a rocket icon and has no title:

This is a default callout.

Jupyter Notebooks

Todo

TODO add how the hound works and how to use it.

LaTeX

It has recently become very popular to write LaTeX equations in markdown. Nextra supports this by using MathJax . You can render LaTeX content either inline between $\LaTeX$ which renders as $\LaTeX$ or as a block using the same syntax as a code block with the three backticks and the math language identifier.

\[I = \int_0^{2\pi} \sin(x)\,dx \]

Luckily Jupyter Notebooks also use MathJax to render LaTeX content in the same way. This means that nextra supports everything. This leads to my LaTeX Notation Guideline to have a consistent notation across all notes.

You can see what is supported by MathJax here .

PlantUML

If you ever need to create diagrams and especially UML diagrams, PlantUML is the way to go. I started with Mermaid to create UML diagrams but swapped to PlantUML for the additional features and the ability to create custom themes (so everything can be minimalist and purple :D).

To render PlantUML diagrams the Remark plugin Simple PlantUML is used which uses the official PlantUML server to generate an image and then adds it.

An Example can be seen below, on the official website and also on REAL WORLD PlantUML .

To use my custom theme you can use the following line at the beginning of the PlantUML file:


@startuml
!theme purplerain from https://raw.githubusercontent.com/LuciferUchiha/georgerowlands.ch/refs/heads/main/

...

@enduml

My custom theme also has some processes built in for simple text coloring for example in cases of success, failure etc.

How can I Contribute?

Do you enjoy the content and want to contribute to the garden by adding some new plants or watering the existing ones? Then feel free to make a pull request. There are however some rules to keep in mind before adding or changing content.

Markdown filenames and folders are written in camelCase.
Titles should follow the IEEE Editorial Style Manual . They should also be added to the markdown file and specified in the _meta.json which maps files to titles and is also responsible for the ordering.
LaTeX should conform with my notation and guideline, if something is not defined there you can of course add it.