← Blog

Hello, World: Publishing My First Post

This is a test post to verify that the markdown-to-static blog pipeline for abdelrahman.work works end to end — from a plain .md file in this repo, all the way to a live page at /blog/hello-world/.

Why a test post first?

Before writing anything real, it's worth confirming the whole loop works:

  • Frontmatter (title, date, description, tags) is parsed correctly
  • Markdown renders with the site's existing design language — same fonts, same theme variables, same card styles used elsewhere on the site
  • The blog listing page picks up the new post automatically
  • sitemap.xml and the robots meta tag update automatically
  • Both light and dark theme still look right

What the pipeline supports

A deliberately small markdown subset, since this is a personal tech blog and not a general-purpose CMS:

  1. Headings (##, ###)
  2. Bold and italic text
  3. Inline code and fenced code blocks
  4. Links and images
  5. Ordered and unordered lists
  6. Blockquotes and horizontal rules
npm run build

No CMS, no database, no API keys — just markdown files, git, and the same npm run build command already used for every other change on this site.


If this post renders correctly with proper styling, spacing, and a working "← Blog" link back to the listing page, the pipeline is confirmed working.