Skip to content
BENIBIX Learn

Markdown and Front Matter

Level 3 · Config and docs files

How Markdown turns a few plain signs into headings, bold words and lists. How front matter puts the title and date of a page at the top.

Course contentsLesson 7 of 11

After this lesson you can

  • Write a heading, bold text and a list in Markdown
  • Add front matter to a Markdown file
  • Write a short README

11 mincovers 3 glossary entries

Worth reading first: .env Files and package.json

How a few plain signs become a neat page

Markdown is a way to format text with plain signs. A # at the start of a line makes a heading, two stars around a word make it bold, and a dash starts a list item. It was made in 2004. The file stays easy to read as it is, and tools turn it into a neat page.

Markdown files end in .md, and they are plain text. You can read one in any editor, even before it is turned into a page. That is the point: the signs look like what they mean.

A space matters after the #. Many tools show #Title as plain text, but # Title as a heading. Two #s make a smaller heading, and three make a smaller one again. A blank line starts a new paragraph.

A README file is the front page of a project, and it is almost always written in Markdown, as README.md. GitHub shows it under the list of files. It says what the project does, how to install it and how to use it.

Front matter is a small block of settings at the very top of a text file. It sits between two lines of three dashes. Inside, it is usually written in YAML, with facts about the file like its title, date and tags. The rest of the file is the content people read.

Site builders and note apps read the front matter. A blog tool uses the title for the page heading and the date to sort the posts. The block itself is not shown on the page.

The common mistake is putting anything above the first three dashes, even a blank line. The front matter must be the very first thing in the file. If it is not, the tool shows the dashes and settings as plain text.

markdown
---
title: My First Post
date: 2026-03-07
tags: [travel, food]
---

# My First Post

A short trip to **Lisbon**.

- Day 1: the old town
- Day 2: the beach
Front matter between the dashes, then a heading, bold text and a list in Markdown.
The settings sit on top, between the dashes. The page people read comes after them.

Worked example

Emma's blog post has no title

Emma writes her 9th blog post, and the page shows three dashes and the words title: and date: at the top.

She sees a blank line above the first dashes. She deletes it, and the post shows its title and sorts by date like the other 8.

The words for this lesson3

Check yourself

Where must front matter go in a Markdown file?

Finished this lesson?

Marking it complete also marks its 3 glossary entries learned, which updates your roadmap and your saved page. 0 are already marked.