Personal portfolio + blog. A single static index.html (no framework, no
runtime dependencies) served by GitHub Pages. Content lives in JSON/Markdown
files and is rendered client-side.
You write posts in plain Markdown — no HTML needed.
- Copy the template:
blog/drafts/_template.md→blog/drafts/my-post.md(use hyphens, no spaces; the file name becomes the URL slug). - Edit the front matter between the
---lines:id: unique number (next available)title: post titledate:YYYY-MM-DDtags:["tag1", "tag2"]excerpt: one-line summary shown in the blog list
- Write your post body in Markdown below the front matter.
- Run the build:
This converts your draft to
npm run build
blog/posts/my-post.html, regeneratesblog/index.json, writes a standalone crawlable page atblog/my-post.html, and updatessitemap.xml. - Commit and push. The post appears automatically.
Headings (#–######), bold, italic, inline code, links
[text](url), images , bullet/numbered lists, > blockquotes,
fenced code blocks (```), and --- rules. Raw HTML also passes
through if you ever need it.
Existing posts authored directly as HTML in
blog/posts/*.htmlstill work — the build picks them up too. New posts should be written as Markdown drafts.
The Infoperhour section is a curated link list stored in data/websites.json.
{
"websites": [
{ "url": "https://example.com/", "name": "Example", "category": "Tech" }
]
}Each entry needs url, name, and category. Categories become filter
buttons automatically. Search filters by name or URL. Favicons load lazily as
you scroll.
- Hash routing between About / Projects / Experience / Infoperhour / Blog / Contact
- Live search + category filters on Infoperhour
- Markdown blog pipeline with a zero-dependency build step
- Automatic dark mode via
prefers-color-scheme - Responsive desktop sidebar + mobile menu
- Reduced-motion aware and keyboard-accessible
# Node (recommended)
npm install -g http-server
http-server -p 8000
# or Python
python -m http.server 8000Then open http://localhost:8000
Push to the repository; GitHub Pages serves it. 100% static, no backend.
Remember to run npm run build before committing if you added/edited posts.