How to Do a Thing

Published on September 28, 2025

This is an example article written in Markdown! Much easier than HTML.

Pro tip: You can use kramdown syntax to add CSS classes to your Markdown elements!

Step 1: Create the Markdown File

Simply create a .md file in your /docs folder. Add front matter at the top for metadata.

Step 2: Write in Markdown

You can use all the standard Markdown features:

• Bold text
• Italic text
• Links
• Code snippets

Code blocks work too:

git add .
git commit -m "Add new article"
git push

Step 3: Add CSS Classes

Use kramdown syntax to add classes:

{: .highlight-box}
This paragraph gets the highlight-box class

{: .text-center}
## This heading will be centered

[Button Link](/)
{: .button}

Step 4: Jekyll Renders It

GitHub Pages will automatically convert your Markdown to HTML with your custom classes!

← Back to Home