whatisgithub

What is gridea?

getgridea/gridea — explained in plain English

Analysis updated 2026-06-24

10,277TypeScriptAudience · writerComplexity · 2/5LicenseSetup · easy

In one sentence

A desktop app for Windows, macOS, and Linux that lets you write Markdown blog posts and publish them as a static website to GitHub Pages or Coding Pages, no coding required.

Mindmap

mindmap
  root((Gridea))
    What it does
      Desktop blog editor
      Markdown writing
      Static site generation
    Publishing
      GitHub Pages
      Coding Pages
      One-click deploy
    Features
      Tags and categories
      Image insertion
      Navigation menus
      Third-party comments
    Platforms
      Windows
      macOS
      Linux
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Start a personal blog without touching code by writing posts in Gridea and publishing them to GitHub Pages for free

USE CASE 2

Switch blog themes to change how your site looks without editing any HTML or CSS

USE CASE 3

Keep your blog posts synced across multiple computers by storing the content folder in OneDrive or Dropbox

USE CASE 4

Enable reader comments on posts by connecting a third-party system like Gitalk without writing backend code

What is it built with?

TypeScriptElectronMarkdown

How does it compare?

getgridea/grideawix/react-native-calendarsinstantdb/instant
Stars10,27710,28210,260
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencewriterdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires a GitHub account and an empty GitHub Pages repository to connect to before you can publish.

Use, copy, modify, and distribute freely for any purpose, including commercial use, as long as you keep the original copyright notice.

So what is it?

Gridea is a desktop application for writing and publishing a personal blog as a static website. You write your posts in Markdown, a simple text formatting style, and the app generates the finished website files for you. Those files can then be published to GitHub Pages or Coding Pages, both of which host static websites for free. The app runs on Windows, macOS, and Linux. You write posts, add tags and categories to organize them, insert images, and set up the navigation menus, all inside the Gridea interface without touching code. When you are ready to publish, the app handles converting your content into web pages and uploading them. Gridea includes built-in themes and also supports third-party themes so you can change how the blog looks. Comments on posts can be enabled by connecting a third-party comment system such as Gitalk or DisqusJS, both of which are external services. The application interface is available in simplified Chinese, traditional Chinese, English, Russian, and French. Because the blog's content files live in a folder on your computer, you can keep that folder synced across multiple devices using services like OneDrive, iCloud, or Dropbox. This lets you write from different machines without losing your posts. The project is open-source under the MIT license and was created by a developer who goes by EryouHao. The README notes the software is still relatively young. Contributions are welcome via pull requests, and the team is reachable through Telegram and QQ group chats.

Copy-paste prompts

Prompt 1
How do I install Gridea on macOS and connect it to my GitHub Pages repository to publish my first blog post?
Prompt 2
Walk me through changing the theme in Gridea and previewing how my blog will look before publishing
Prompt 3
How do I add tags and categories to posts in Gridea so readers can filter my blog by topic?
Prompt 4
How do I set up Gitalk comments on my Gridea blog so readers can leave comments using their GitHub accounts?

Frequently asked questions

What is gridea?

A desktop app for Windows, macOS, and Linux that lets you write Markdown blog posts and publish them as a static website to GitHub Pages or Coding Pages, no coding required.

What language is gridea written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, Markdown.

What license does gridea use?

Use, copy, modify, and distribute freely for any purpose, including commercial use, as long as you keep the original copyright notice.

How hard is gridea to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is gridea for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.