# getgridea/gridea

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/getgridea-gridea).**

10,276 stars · 838 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/getgridea/gridea
- Homepage: https://open.gridea.dev
- awesome-repositories: https://awesome-repositories.com/repository/getgridea-gridea.md

## Topics

`blog` `blog-engine` `blog-platform` `cms` `electron` `electronjs` `gridea` `jamstack` `macos` `static-blog` `static-site` `static-site-cms` `static-site-generator` `typescript` `vue` `vue2` `windows`

## Description

Gridea is a desktop application for writing Markdown blog posts and publishing them as a static site without needing a server. It stores all content as plain Markdown files and JSON in a local folder, compiles them into a static site, and deploys the result to multiple remote targets including GitHub Pages, Coding Pages, and SFTP servers.

The application runs as a cross-platform Electron client, providing a native editing and publishing experience. It supports custom themes that can be selected, installed from a built-in marketplace, and configured with settings like social links and analytics. The Markdown editor includes extended syntax support for task lists, footnotes, LaTeX mathematical formulas, and emoji insertion, along with keyboard shortcuts and clipboard image pasting.

Content management features include article taxonomy through tags and labels, customizable navigation menus, clean or default URL formats, RSS feed generation, and comment system integration with Gitalk or DisqusJS. The source folder can be stored in a cloud-synced directory to enable editing and publishing from multiple devices.

## Tags

### Content Management & Publishing

- [Markdown Editors](https://awesome-repositories.com/f/content-management-publishing/content-formats-exporting/content-formats/markdown-editors.md) — Provides a built-in Markdown editor for composing and formatting blog posts. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))
- [Static Blogging Systems](https://awesome-repositories.com/f/content-management-publishing/static-blogging-systems.md) — A desktop application for writing Markdown posts and publishing them as a static site without a server.
- [Static Site Generators](https://awesome-repositories.com/f/content-management-publishing/static-site-generators.md) — Compiles Markdown content into a complete static site using a local desktop client.
- [Markdown-Based Content Storage](https://awesome-repositories.com/f/content-management-publishing/content-formats-exporting/content-formats/markdown-based-content-storage.md) — Stores all blog content and configuration as plain Markdown files in a user-managed folder.
- [Technical Extended Syntax](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/markdown-markup-tools/markdown-tools/markdown-renderers/multi-syntax-renderers/technical-extended-syntax.md) — Renders extended Markdown syntax including task lists, footnotes, and image sizing. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [Markdown Editors](https://awesome-repositories.com/f/content-management-publishing/markdown-documentation/markdown-editors.md) — Provides a dedicated Markdown editor with keyboard shortcuts and an emoji picker. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [KaTeX Renderers](https://awesome-repositories.com/f/content-management-publishing/markdown-renderers/mathematical-notation-renderers/katex-renderers.md) — Displays LaTeX equations using KaTeX within the article body. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [Markdown to HTML Converters](https://awesome-repositories.com/f/content-management-publishing/markdown-to-html-converters.md) — Converts Markdown articles into HTML pages with support for LaTeX and footnotes.
- [Static Site Themes](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes.md) — Renders the static site by applying user-selected themes with template files.
- [Comment System Integrations](https://awesome-repositories.com/f/content-management-publishing/comment-system-integrations.md) — Integrates Gitalk or DisqusJS comment systems into blog posts through simple configuration.
- [Comment Systems](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/comment-systems.md) — Configures Gitalk or DisqusJS to add discussion threads to blog posts. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))
- [Navigation Menu Configurators](https://awesome-repositories.com/f/content-management-publishing/navigation-menu-configurators.md) — Creates site menus with internal pages or external links for visitor navigation. ([source](https://github.com/getgridea/gridea/blob/master/README-zh_CN.md))
- [RSS Feed Generation](https://awesome-repositories.com/f/content-management-publishing/rss-feed-generation.md) — Generates an Atom feed of recent posts for reader subscription. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))

### Part of an Awesome List

- [Markdown Editors](https://awesome-repositories.com/f/awesome-lists/productivity/markdown-editors.md) — Formats articles with Markdown syntax and provides live preview and keyboard shortcuts.
- [Cloud-Synced Source Editors](https://awesome-repositories.com/f/awesome-lists/productivity/blogging-and-publishing/cloud-synced-source-editors.md) — Syncs blog source folders across devices using cloud storage to edit and publish from multiple machines.

### Development Tools & Productivity

- [Cross-Platform Desktop Clients](https://awesome-repositories.com/f/development-tools-productivity/cross-platform-desktop-clients.md) — Ships a cross-platform desktop client built with Electron for native editing and publishing.
- [Static Site SFTP Deployers](https://awesome-repositories.com/f/development-tools-productivity/remote-file-transfers/sftp-subsystems/sftp-client-libraries/static-site-sftp-deployers.md) — Deploys the generated static blog to remote servers via SFTP from the desktop client. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [Cloud File Sync](https://awesome-repositories.com/f/development-tools-productivity/cloud-file-sync.md) — Stores blog source files in a user-chosen folder shareable via cloud storage. ([source](https://github.com/getgridea/gridea/blob/master/README-zh_CN.md))

### DevOps & Infrastructure

- [GitHub Pages Deployments](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/static-site-deployments/portfolio-hosting/github-pages-deployments.md) — Publishes static blog sites directly to GitHub Pages from a desktop client. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))
- [Multi-Platform Deployments](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/static-site-deployments/portfolio-hosting/github-pages-deployments/multi-platform-deployments.md) — Publishes generated static sites to GitHub Pages, Coding Pages, and SFTP servers.
- [Multi-Platform Site Deployment](https://awesome-repositories.com/f/devops-infrastructure/multi-platform-site-deployment.md) — Publishes the static site to both GitHub Pages and Coding Pages from the same client. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [GitHub Pages Deployments](https://awesome-repositories.com/f/devops-infrastructure/release-automation/github-release-automators/github-pages-deployments.md) — Publishes a static blog site directly to GitHub Pages from within the desktop application.

### User Interface & Experience

- [Theme Customization](https://awesome-repositories.com/f/user-interface-experience/visual-theme-configurations/visual-themes/theme-customization.md) — Selects and applies custom themes to change the visual appearance of the static blog site. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))
- [Marketplace Theme Browsers](https://awesome-repositories.com/f/user-interface-experience/built-in-theme-selectors/marketplace-theme-browsers.md) — Provides a built-in marketplace to browse and install community-contributed themes. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [Custom Template Renderers](https://awesome-repositories.com/f/user-interface-experience/control-template-customizations/custom-template-renderers.md) — Applies user-defined template files to control how blog content is rendered on the site. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))
- [Custom Navigation Items](https://awesome-repositories.com/f/user-interface-experience/navigation-links/custom-navigation-items.md) — Edits menus and adds external links to tailor the blog's navigation structure. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))
- [Theme Settings Configurations](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/theme-management/theme-development/theme-settings-configurations.md) — Defines custom settings like social links, analytics, and styles through a theme configuration interface. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))

### Data & Databases

- [Content Tagging](https://awesome-repositories.com/f/data-databases/content-tagging.md) — Groups blog entries by custom tags for structured browsing. ([source](https://github.com/getgridea/gridea/blob/master/README-zh_CN.md))
- [Cloud Drive Sync](https://awesome-repositories.com/f/data-databases/data-persistence-layers/cloud-drive-sync.md) — Stores the blog source folder in a cloud drive for multi-device editing. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))
- [Item Tagging and Organization](https://awesome-repositories.com/f/data-databases/tag-based-search/item-tagging-and-organization.md) — Assigns tags and labels to articles for content organization. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))

### Software Engineering & Architecture

- [Content Taxonomies](https://awesome-repositories.com/f/software-engineering-architecture/taxonomy-systems/content-taxonomies.md) — Organizes posts by assigning labels and grouping them into categories. ([source](https://cdn.jsdelivr.net/gh/getgridea/gridea@master/README.md))

### Web Development

- [Custom Domain Hosting](https://awesome-repositories.com/f/web-development/custom-domain-hosting.md) — Sets a CNAME record to serve the blog from a personal domain. ([source](https://github.com/getgridea/gridea/blob/master/CHANGELOG.md))