maru's blog el blog de maru

← home← inicio · all poststodos los posts

hello world

18/11/2026

ey! this is the first post on my tiny blog. it’s mostly a note to future me on how to write new posts, because I will forget.

how I make a new post

  1. I make a new file in _posts/ named YYYY-MM-DD-some-title.md, for example 2026-12-01-my-cool-post.md. the date and the title in the filename are required, Jekyll ignores the file otherwise. the part after the date becomes the URL, so I keep it lowercase with dashes.

  2. at the very top of the file I put the front matter:

    ---
    title: my cool post
    ---
    

    that’s all I need, the layout is already set in _config.yml.

  3. I write the post in markdown under that. bold, italics, code, links, lists, headings with ##, all of it works.

  4. the first paragraph is what shows up as the preview on the homepage, so I try to make it a nice short intro. if I want a different preview, I add excerpt: "whatever I want" to the front matter.

  5. I commit and push to main. GitHub Pages rebuilds the site by itself in a minute or two. the newest post goes on the homepage automatically and gets added to all posts.

things I should remember

that’s it. now go write something, maru.