Simple guide to submit an article

This guide is for anyone who wants to send me an article to publish on the blog. You don’t need to know programming: just fill in the main fields and write the text.

1) Fill in the initial fields (frontmatter)

At the top of the file there are these fields. Fill them out like this:

---
title: 'Title of your article'
description: 'Short description (1-2 sentences)'
tags: ['category1', 'category2']
complexity: 'normale'
pubDate: '15/01/2025'
heroImage: '../../assets/cover-image.jpg'
---

Quick explanation:

• title: the title that will appear on the blog.
• description: a short summary (used for preview and SEO).
• tags: useful categories for filtering (optional).
• complexity: technical complexity level (normale, alto).
• pubDate: publication date (format DD/MM/YYYY).
• heroImage: cover image (optional). If you don’t have it, leave a placeholder or a link.

2) Write the article text

After the initial block, you can write the content. Use short sentences and separate paragraphs with a blank line.

Titles and sections

To create headings:

# Main title
## Section
### Subsection

Lists

Example of a bullet list:

- Point 1
- Point 2
- Point 3

Example of a numbered list:

1. First point
2. Second point
3. Third point

Links

To insert a link:

[Link text](https://www.example.com)

Images

To insert an image in the text:

![Image description](../../assets/image-name.jpg)

If you don’t have the image ready, you can write only the text and tell me where to place it.

3) Practical tips

• Write a short introduction explaining what the article is about.
• Use headings to separate topics.
• End with a summary or a call to action.

If you want, you can send me just the text and the initial data: I’ll handle the rest.