Say Hello to Grav 2.0!

installation successful...

Congratulations! You have installed the Base Grav 2.0 Package that provides a simple page and the new default Quark 2 theme to get you started — built on Blades CSS (the actively maintained successor to Pico CSS), Font Awesome 7, and a refined typographic system with light/dark/auto appearance.

Warning

If you see a 404 Error when you click Typography in the menu, please refer to the troubleshooting guide.

Find out all about Grav

Tip

If you want a more full-featured base install, check out the Skeleton packages available in the downloads — several have already been updated for Grav 2.0.

Edit this Page

To edit this page, navigate to the folder you installed Grav into, and browse to the user/pages/01.home folder. Open default.md in your editor of choice. You'll see the content of this page written in Markdown format.

Create a New Page

Creating a new page is a simple affair in Grav. Follow these steps:

  1. Navigate to your pages folder — user/pages/ — and create a new folder. In this example, we'll use explicit default ordering and call the folder 03.mypage.

  2. Launch your text editor and paste in the following sample content:

    ---
    title: My New Page
    ---
    # My New Page!
    
    This is the body of **my new page** and I can easily use _Markdown_ syntax here.
  3. Save this file in user/pages/03.mypage/ as default.md. That tells Grav to render the page using the default template from Quark 2.

  4. Reload your browser to see your new page appear in the menu.

Note

The page will automatically show up in the menu after the Typography item. If you want a different label, add menu: My Page between the dashes in the front matter — this is the YAML header block, where all per-page options are configured.

What's new in Grav 2.0

Grav 2.0 is the biggest release in the project's history — a modernized core, a rebuilt admin, a fresh default theme, and an updated dependency stack. Most of what you already know still works, but everything underneath has been sharpened.

Important

Upgrading from Grav 1.x requires a migration. Follow the step-by-step guide at getgrav.org/migrate-to-2 — it covers pre-flight checks, the migration itself, and what to verify afterward.

Note

Quark 2 is Grav 2.0's default theme. It uses Blades CSS (the actively maintained successor to Pico CSS) as a classless foundation, layered with a Cal.com-inspired design system. Full Blades capabilities are documented in the Official Blades CSS Docs.

The Quark 2 theme is Grav's new default, replacing the long-serving Quark (1.x) theme. It pairs a pure-grayscale palette with Cal Sans for display and Inter for body text (both hosted locally), Font Awesome 7 icons, and auto/light/dark appearance that persists in the user's browser. The layout system is CSS Grid + modern custom properties rather than a framework grid.

Headings

Quark 2 uses Cal Sans for display headings and treats h1 / h2 distinctly — h1 sits at a lighter display weight while h2 is bolder and gains a small accent bar to mark section breaks. h6 is rendered as an uppercase eyebrow label.

H1 Heading — airy, display weight

H2 Heading — confident, with accent bar

H3 Heading — workhorse section heading

H4 Heading

H5 Heading
H6 Heading — uppercase eyebrow
# H1 Heading
## H2 Heading
### H3 Heading
#### H4 Heading
##### H5 Heading
###### H6 Heading

Paragraphs

Body copy is set in Inter at 16px with a 1.7 line-height and subtle tracking. Links adopt the theme's accent color — by default a restrained charcoal, but configurable to any hex via Themes → Quark 2 → Accent Color.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent risus leo, dictum in vehicula sit amet, feugiat tempus tellus. Duis quis sodales risus. Etiam euismod ornare consequat.

Climb leg rub face on everything give attitude nap all day for under the bed. Chase mice attack feet but rub face on everything hopped up on goofballs.

Markdown Semantic Text Elements

Bold **Bold**

Italic _Italic_

Deleted ~~Deleted~~

Inline Code `Inline Code`

HTML Semantic Text Elements

I18N <abbr>

Citation <cite>

Ctrl + S <kbd>

TextSuperscripted <sup>

TextSubscripted <sub>

Underlined <u>

Highlighted <mark>

<time>

x = y + 2 <var>

Blockquote

The advance of technology is based on making it fit in so that you don't really even notice it, so it's part of everyday life.

- Bill Gates

> The advance of technology is based on making it fit in so that you don't really even notice it,
> so it's part of everyday life.
>
> <cite>- Bill Gates</cite>

Unordered List

* list item 1
* list item 2
    * list item 2.1
    * list item 2.2
    * list item 2.3
* list item 3

Ordered List

  1. list item 1
  2. list item 2
    1. list item 2.1
    2. list item 2.2
    3. list item 2.3
  3. list item 3
1. list item 1
1. list item 2
    1. list item 2.1
    1. list item 2.2
    1. list item 2.3
1. list item 3

Table

Name Genre Release date
The Shawshank Redemption Crime, Drama 14 October 1994
The Godfather Crime, Drama 24 March 1972
Schindler's List Biography, Drama, History 4 February 1994
Se7en Crime, Drama, Mystery 22 September 1995
| Name                        | Genre                         | Release date         |
| :-------------------------- | :---------------------------: | -------------------: |
| The Shawshank Redemption    | Crime, Drama                  | 14 October 1994      |
| The Godfather               | Crime, Drama                  | 24 March 1972        |
| Schindler's List            | Biography, Drama, History     | 4 February 1994      |
| Se7en                       | Crime, Drama, Mystery         | 22 September 1995    |

Alerts

Grav 2.0 replaces the legacy markdown-notices plugin with github-markdown-alerts, which renders GitHub-flavored Markdown alerts. Five types are available, each with an accent stripe, icon, and label:

Note

Highlights information that users should take into account, even when skimming.

Tip

Optional information to help a user be more successful.

Important

Crucial information necessary for users to succeed.

Warning

Critical content demanding immediate user attention due to potential risks.

Caution

Negative potential consequences of an action.

> [!NOTE]
> Highlights information that users should take into account, even when skimming.

> [!TIP]
> Optional information to help a user be more successful.

> [!IMPORTANT]
> Crucial information necessary for users to succeed.

> [!WARNING]
> Critical content demanding immediate user attention due to potential risks.

> [!CAUTION]
> Negative potential consequences of an action.