explaingit

getgridea/gridea

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

TLDR

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

Things people build with this

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

Tech stack

TypeScriptElectronMarkdown

Getting 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.

In plain English

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?
Open on GitHub → Explain another repo

← getgridea on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.