Grid Reference

Terminal for MkDocs Tile Grid can be further customized using the following configuration options. These options should be specified in the markdown page's metadata in the same way that tiles are specified:

---
show_tiles_first: true
tiles:
  - caption: '@petradr'
    ...
---

# Page Content as usual

Configuration Options

show_tiles_first

Defaults to false. If true, tiles will be added to the final page above the main page content. If false (or unspecified), tiles will be added to the final page below the main content.
Ignored if show_tiles_inline is true.

show_tiles_inline

Defaults to false. If true, tiles will be rendered on the final page using the Tile Grid Pluglet (if enabled).

grid_id

ID to add to the grid's HTML for advanced styling.
See Override Styling for example.

grid_css

CSS class to add to the grid's HTML for advanced styling.
See Override Styling for example.

Default Tile Placement

See Example Page

Markdown

---
tiles:
  - caption: '@petradr'
    img_src: ../../../img/picsum/167_200x200.jpeg
    tooltip: 'to Picsum homepage'
    alt_text: 'Picsum Photo API.'
    link_href: https://picsum.photos/ 
  - caption: 'Marcin Czerwinski'
    img_src: ../../../img/picsum/127_200x200.jpeg
    tooltip: 'to Picsum homepage'
    alt_text: 'Picsum Photo API.'
    link_href: https://picsum.photos/ 
  - caption: 'Steve Richey'
    img_src: ../../../img/picsum/143_200x200.jpeg
    tooltip: 'to Picsum homepage'
    alt_text: 'Picsum Photo API.'
    link_href: https://picsum.photos/ 
---

# My Page Content
Aliquam eu augue hendrerit, bibendum felis sit amet, commodo lorem.

Maecenas facilisis id tortor volutpat fermentum. Integer volutpat arcu leo, sed semper sapien facilisis ut. Nam ac tincidunt sem, eu gravida augue. Suspendisse varius facilisis rhoncus. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aliquam elementum vitae lacus a sodales. 

<br>

Tiles First

See Tiles First Example

Markdown

---
show_tiles_first: true
tiles:
  - caption: '@petradr'
    img_src: ../../../img/picsum/167_200x200.jpeg
    alt_text: 'close up of fallen leaves.'
  - caption: 'Marcin Czerwinski'
    img_src: ../../../img/picsum/127_200x200.jpeg
    alt_text: 'close up of green moss on a log.'
  - caption: "Steve Richey"
    img_src: ../../../img/picsum/143_200x200.jpeg
    alt_text: 'overhead of fallen leaves.'
---

# Image Only Tiles 
The tiles on this page do not have a `link_href` attribute.  They are rendered as static images instead of linked images.

# Tiles First
The tiles on this page are placed before the main page content.  This is because the [grid option](../grid.md) `show_tiles_first` is set to `true`.


## Markdown

```markdown
---
show_tiles_first: true
tiles:
  - caption: '@petradr'
    img_src: ../../../img/picsum/167_200x200.jpeg
    alt_text: 'close up of fallen leaves.'
  - caption: 'Marcin Czerwinski'
    img_src: ../../../img/picsum/127_200x200.jpeg
    alt_text: 'close up of green moss on a log.'
  - caption: "Steve Richey"
    img_src: ../../../img/picsum/143_200x200.jpeg
    alt_text: 'overhead of fallen leaves.'
---