Setting Up Your Own Jekyll Markdown Blog with QNAP NAS Container Station

The Problem

1. Everyone on the team maintains their own Markdown documents. Over time, as the number of docs grows, there is no effective way to manage them.
2. There are too many scattered HackMD links, and new team members spend extra time just organizing them.
3. There is no way to categorize or search across documents.

Why Jekyll?

1. Helps the team manage technical knowledge and documentation
2. Has built-in pagination and search
3. Tags allow effective categorization
4. Uses Markdown syntax
5. Free
6. Stable and widely used (42.5k+ GitHub stars)

Drawbacks

1. No built-in live online editor

Hardware

QNAP TS-253D running Container Station

Installation Steps

1. Go to Create > Search, and pull the jekyll/jekyll image from Docker Hub.

2. Under Command, enter the startup command and set the Blog document directory:

   jekyll serve --source /jekyll_data
   

   

3. Mount a local disk path to the Blog document storage location.

4. After Docker starts, open the terminal and install the tagging gem required by the theme:

   gem install jekyll-tagging
   

   

5. Find a theme you like on a Jekyll themes site. This example uses the zolan theme — download and extract it into the mapped local directory.

6. Restart your Docker container, then click the Connect link — your Markdown Blog should now be live.

Theme Resources

1. Free: http://jekyllthemes.org/
2. Paid: https://jekyllthemes.io/