Write for MakerGram

Every post from here on lives as a Markdown file in MakerGram/makergram.com. No Ghost, no separate CMS. You write in a text editor, open a pull request, and it goes live when we tag a release.

What to write

Build logs, how-tos, event recaps, “I tried X so you don’t have to”. A first Arduino project is as welcome as a production board. Aim for something another maker can follow or learn from.

Keep the voice like you would in the Telegram group: clear, specific, a bit messy is fine. We can help you edit.

Fastest path: pitch in Telegram

Not comfortable with Git? Send a draft (Google Doc, Markdown, even a long message) in the MakerGram Telegram group. Someone will help you get it into the repo.

Publish it yourself

1. Fork MakerGram/makergram.com.

2. Create a folder for the post. The folder name is the URL slug:

   content/blog/my-post-slug/index.md

3. Put images in that same folder. Name the hero image cover.jpg (PNG or GIF is also fine).

4. Fill in the front matter (the bit between --- at the top):

title: How I built a meshtastic node for my bike
date: 2026-10-28
author: Your Name
authors:
  - Your Name
description: A weekend build using a Heltec V3, a 18650 and a 3D-printed case.
tags:
  - meshtastic
  - lora

authors must match the name on the line above. That is what builds the author page.

5. Write the post in Markdown. For a captioned image:

{{< figure src="photo.jpg" alt="The node mounted on the stem" caption="Heltec V3 in a printed case, zip-tied to the stem." >}}

6. Open a pull request against main. Staging updates on merge; the public site updates when we tag a release (for example 26.11.1).

If you already have Hugo installed:

hugo new content blog/my-post-slug/index.md
hugo server

First-time authors

If your name is not yet on the authors list, add two small files in the same pull request:

• data/authors.yaml — a new entry with your name, and optional github, twitter, linkedin and photo.
• content/authors/your-name/_index.md:

---
title: Your Name
slug: yourname
---

Put a square photo at static/images/authors/your-name.jpg. The slug becomes /blog/author/yourname/.

House style

• One idea per post. Link out instead of repeating a whole datasheet.
• Real photos of your bench beat stock renders.
• Keep GIFs small. Anything over a few megabytes will bloat the build.
• Credit people, boards and licences. Link the repo if there is one.
• Drafts: set draft: true in the front matter until you are ready.

Questions? Ask on Telegram or open an issue on the repo.