markdown-reference.md shows every prose style but uses layout: article defaults — it doesn’t set category or tags. This file fills those in so the /articles/ index, filter chips, and tag pages render something on a fresh fork.

Front matter contract

• category must match a slug in _data/categories.yml (here: tech).
• tags are free-form. Tags that match a project tag will share a chip.
• lang is informational for now — reserved for future i18n.

Deleting me

Safe to delete once you’ve added your own articles. The portfolio and article collections both render zero-state UI when empty, so you won’t break anything.

This is a blockquote. It renders in the phosphor accent border on article pages.

// Code blocks keep the phosphor syntax theme.
function greet(name) {
  return `Hello, ${name}`;
}

H1 Heading

H2 Heading

H3 Heading

H4 Heading

H5 Heading

H6 Heading

Inline Formatting

Body text with bold, italic, bold italic, strikethrough, inline code, and a link.

A paragraph mixing everything: bold with italic and code inside, followed by a link with bold and deleted text.

Lists

Unordered:

• First item
• Second item
  • Nested under second
  • Another nested
    • Deeper still
• Back to top level

Ordered:

1. Open the file
2. Run the build
3. Verify output
   1. Check _site/
   2. Check console for errors
4. Ship it

Task list:

• Set up Jekyll
• Write content
• Add tests
• Deploy

Code Blocks

Inline: run bundle exec jekyll serve to start.

@use "variables" as *;
@use "mixins" as *;

.button {
  @include phosphor-glow;
  background: $phosphor;
  color: $bg-void;
  padding: 1rem 2rem;

  &:hover { background: $phosphor-bright; }
  &:active { transform: translateY(1px); }
}

# Render the site
site = Jekyll::Site.new(Jekyll.configuration({}))
site.process
puts "Built in #{site.time}ms"

name: example
title: "Sample Article"
tags: [Tag1, Tag2]

Plain code block — no language hint.
Should still render readably.

Blockquotes

A blockquote with bold, italic, and code inside it.

Second paragraph in the same quote.

Nested blockquote — quieter accent stripe.

Tables

Horizontal Rule

Text above.

Text below.

Image

Definition List

Jekyll

Static site generator written in Ruby.

Bundler

Manages Ruby gem dependencies via Gemfile.lock.

Rouge

Pure-Ruby syntax highlighter used by Jekyll.

Footnote

The site uses a PJAX router for soft navigation¹. It also supports a custom cursor² on fine-pointer devices.

Keyboard & Special

Press Ctrl + C to copy. Use Esc to close the lightbox. The highlighted phrase stands out from surrounding text. Hover over HTML for the expansion.

Mixed Content

1. First, set up the project:

   bundle init
   bundle add jekyll
   

2. Then, configure _config.yml:

   The config file controls collections, permalinks, and excludes. Keep it minimal.

3. Finally, build and serve:

   bundle exec jekyll serve --livereload
   

   The site runs at http://127.0.0.1:4000/.