blog/themes/stack/demo/content/post/Image Gallery/index.md
2026-07-31 15:38:57 +08:00

43 lines
1.3 KiB
Markdown

---
title: Image Gallery
description: Showcasing the built-in image gallery support
date: 2026-01-26
slug: image-gallery
image: helena-hertz-wWZzXlDpMog-unsplash.jpg
categories:
- Documentation
tags:
- Gallery
- Photoswipe
toc: false
---
Stack theme has a built-in support for image galleries. It allows you to create a beautiful gallery by simply placing multiple images side-by-side.
## Sample Gallery
![Photo by Florian Klauer on Unsplash](florian-klauer-nptLmg6jqDo-unsplash.jpg) ![Photo by Luca Bravo on Unsplash](luca-bravo-alS7ewQ41M8-unsplash.jpg)
![Photo by Helena Hertz on Unsplash](helena-hertz-wWZzXlDpMog-unsplash.jpg) ![Photo by Hudai Gayiran on Unsplash](hudai-gayiran-3Od_VKcDEAA-unsplash.jpg)
## How it works
The gallery is powered by **Photoswipe** and a custom internal script. It automatically calculates the best layout for your images based on their aspect ratios.
To create a gallery, you just need to put multiple images in the same line (or paragraph).
### Syntax
```markdown
![Image 1](image1.jpg) ![Image 2](image2.jpg)
![Image 3](image3.jpg) ![Image 4](image4.jpg)
```
> **Note**: There should be two spaces between the images to ensure they stay in the same line in Markdown
---
Gallery Syntax inspired by [Typlog](https://typlog.com/)