Welcome to my technical blog

· 1 min read

Kickoff post: how this blog is built and what you can expect to read here.

solidjsvitemarkdown

Why a blog?

I built this space to share the notes and lessons I gather while working on side projects and production systems. Expect deep dives on SolidJS, .NET, Java, Angular, and the tooling around them.

Markdown power

Articles are written as plain Markdown files, so I can focus on content. The renderer supports the usual suspects out of the box:

  • Headings, lists, and blockquotes
  • Tables
  • Links and images
  • Fenced code blocks with syntax highlighting
  • Mermaid diagrams

Syntax highlighting

Code blocks are highlighted automatically based on the language tag:

export interface Feature<T> {
  run(input: T): Promise<T>
}

export const identity = <T,>(value: T): T => value
public sealed class Greeter
{
    public string Hello(string name) => $"Hello, {name}!";
}

Mermaid diagrams

Diagrams render from a mermaid code block:

flowchart TD
    A[Write Markdown] --> B{Contains mermaid?}
    B -- Yes --> C[Render SVG diagram]
    B -- No --> D[Render plain HTML]
    C --> E[Show article]
    D --> E

Sequence diagrams work too:

sequenceDiagram
    participant Client
    participant API
    participant Cache
    Client->>API: GET /posts
    API->>Cache: lookup
    alt hit
        Cache-->>API: data
    else miss
        API-->>API: build response
        API->>Cache: store
    end
    API-->>Client: 200 OK

Wrapping up

That is the basics. Stay tuned for more detailed technical articles.