grav

Page Editing

Pages in Grav are composed in Markdown syntax. Markdown is a plain text formatting syntax that a computer can readily parse and convert to HTML. It uses basic text symbols to indicate presentation (e.g. bold, italics, headings, lists, etc.), making it easy to write without needing to know t...…
Ana Ana
Page Editing
Share this

Pages in Grav are composed in Markdown syntax. Markdown is a plain text formatting syntax that a computer can readily parse and convert to HTML. It uses basic text symbols to indicate presentation (e.g. bold, italics, headings, lists, etc.), making it easy to write without needing to know the complexities of HTML. Benefits of Markdown include lower error rate, readability, ease of learning and use, etc.

You can read an extensive write-up of available syntax with examples in the documentation, but for now, follow along.

Open the home page in your text editor. The file that controls the homepage is located in the user/pages/01.home/ folder and is called default.md. All of the content you create will be created in the user/pages/ folder in your Grav installation.

When you edit the page in a text editor, the content will look something like this:

---
title: Home
body_classes: title-center title-h1h2
---
# Say Hello to Grav!
## installation successful...

Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.

!! If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](https://learn.getgrav.org/troubleshooting/page-not-found).

Let us break this down a little so you can see how easy it is to write in Markdown. The stuff between the --- indicators are the Page Headers, and these are written in a straightforward format called YAML. This configuration block that sits in the .md file is commonly known as YAML Front Matter.

title: Home
body_classes: title-center title-h1h2

This block sets the HTML title tag for the page (the text you see in the browser tab). You can also access this from your themes via the page.title attribute. There are a few standard headers that let you configure a variety of options for this page. Another example is menu: Something that lets you override the text used to display the name of the page in a menu. By default, Grav will use the title for the menu value.

# Say Hello to Grav!
## installation successful...

The # or hashes syntax in markdown indicates a title. A single # with a space and then text converts into an <h1> header in HTML. ## or double hash would convert into an <h2> tag. Of course, this goes all the way up to the HTML valid <h6> tag which of course, would be six hashes: ###### My H6 Level Header.

Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **Quark** theme to get you started.

This is a simple paragraph that would have been wrapped in regular <p> tags when converted to HTML. The ** markers indicate bold text or <strong>, formerly <b>, in HTML. Italic text is indicated by wrapping text in _ markers.

!! If you see a **404 Error** when you click `Typography` in the menu, please refer to the [troubleshooting guide](https://learn.getgrav.org/troubleshooting/page-not-found).

This section uses a custom markdown feature that is provided by the included markdown-notices plugin. This allows you to create simple notices by prefix a paragraph of text with a number of ! (exclamation mark) symbols, from ! to !!!!.

This overview should provide you with a few key pointers for writing Markdown, but you should check out our more detailed explanation to get a thorough understanding.

Ensure you save your .md files as UTF8 files. This will ensure they work with language-specific special characters.

Subscribe to our newsletter

Get the latest news right in your inbox. We never spam!. You can unsubscribe at any time.
Ana

Written by Ana

Blogger, fashionista, love to explore new ideas and write on my morning coffee!

Related pages

Welcome to Grav!

Welcome to Grav!

Pedro Moreno in editors, grav
Taxonomy

Taxonomy

Pedro in grav
Markdown Syntax

Markdown Syntax

Pedro in grav