# hexojs/hexo

**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/hexojs-hexo).**

41,251 stars · 5,034 forks · TypeScript · mit

## Links

- GitHub: https://github.com/hexojs/hexo
- Homepage: https://hexo.io
- awesome-repositories: https://awesome-repositories.com/repository/hexojs-hexo.md

## Topics

`hacktoberfest` `hexo` `javascript` `nodejs` `static-site-generator` `typescript`

## Description

Hexo is a command-line static site generator designed for content-driven blogging and website creation. It functions as a structured framework that transforms plain text files and markdown into production-ready static websites, utilizing a template-based rendering engine to separate site content from visual presentation.

The project is distinguished by its event-driven build pipeline, which manages the entire site lifecycle through a series of hooks for file processing, asset generation, and deployment. Developers can extend the system’s core capabilities through a modular plugin architecture, allowing for custom rendering engines and specialized site-wide functionality. The platform also provides a local development server for real-time previewing and file change monitoring to ensure efficient build performance during the authoring process.

Beyond its core generation capabilities, the system includes comprehensive tools for managing site metadata, URL structures, and content organization through front-matter configuration. It supports complex asset management, including post-specific folders and automated path resolution, alongside a suite of tag plugins for injecting dynamic elements like code blocks and media directly into content. The platform also features built-in deployment automation, enabling direct synchronization of generated files to various remote hosting environments and cloud platforms.

Hexo is installed and managed via command-line utilities, with documentation and configuration centered around a project-based directory structure.

## Tags

### Content Management & Publishing

- [Static Site Generators](https://awesome-repositories.com/f/content-management-publishing/static-site-generators.md) — Transforms source files and templates into a complete, production-ready website.
- [Theme Layouts](https://awesome-repositories.com/f/content-management-publishing/theme-layouts.md) — Defines website appearance through flexible template files that support multiple rendering engines. ([source](https://hexo.io/docs/themes))
- [Content Management Systems](https://awesome-repositories.com/f/content-management-publishing/content-management-systems.md) — Provides a structured environment for authoring and publishing content.
- [Front Matter Parsers](https://awesome-repositories.com/f/content-management-publishing/front-matter-parsers.md) — Uses front-matter blocks to configure post and page metadata for rendering and classification. ([source](https://hexo.io/docs/front-matter))
- [Site Metadata Managers](https://awesome-repositories.com/f/content-management-publishing/site-metadata-managers.md) — Configures core site metadata including title, author, and localization settings. ([source](https://hexo.io/docs/configuration))
- [Blogging Systems](https://awesome-repositories.com/f/content-management-publishing/blogging-systems.md) — Manages collections of articles with support for metadata and categories.
- [Content Renderers](https://awesome-repositories.com/f/content-management-publishing/content-renderers.md) — Supports various file formats through configurable renderer plugins for site generation. ([source](https://hexo.io/docs/writing))
- [Permalink Generators](https://awesome-repositories.com/f/content-management-publishing/permalink-generators.md) — Configures custom URL structures for posts using dynamic variables. ([source](https://hexo.io/docs/permalinks))
- [Template Partials](https://awesome-repositories.com/f/content-management-publishing/template-partials.md) — Enables the inclusion of reusable template components to maintain consistent site structure. ([source](https://hexo.io/docs/templates))
- [Global Site Variables](https://awesome-repositories.com/f/content-management-publishing/global-site-variables.md) — Provides access to site-wide configuration and metadata for dynamic rendering. ([source](https://hexo.io/docs/variables))
- [Theme Managers](https://awesome-repositories.com/f/content-management-publishing/theme-managers.md) — Manages active themes and overrides theme-specific configurations. ([source](https://hexo.io/docs/configuration))
- [Content Listing Generators](https://awesome-repositories.com/f/content-management-publishing/content-listing-generators.md) — Generates lists of categories, tags, archives, and posts with configurable sorting. ([source](https://hexo.io/docs/helpers))
- [Content Parsers](https://awesome-repositories.com/f/content-management-publishing/content-parsers.md) — Intercepts specific markers in source files to inject dynamic HTML or assets.
- [Content Taxonomies](https://awesome-repositories.com/f/content-management-publishing/content-taxonomies.md) — Defines custom slug mappings for categories and tags to organize content structure. ([source](https://hexo.io/docs/configuration))
- [Index Generators](https://awesome-repositories.com/f/content-management-publishing/index-generators.md) — Customizes home page index generation with pagination and ordering preferences. ([source](https://hexo.io/docs/configuration))
- [Layout Management Systems](https://awesome-repositories.com/f/content-management-publishing/layout-management-systems.md) — Defines structural layouts for pages to share common elements like headers and footers. ([source](https://hexo.io/docs/templates))
- [Template Caching](https://awesome-repositories.com/f/content-management-publishing/template-caching.md) — Caches rendered template fragments to optimize build times for static content. ([source](https://hexo.io/docs/templates))
- [URL Routers](https://awesome-repositories.com/f/content-management-publishing/url-routers.md) — Defines the website URL structure and root directory for generated links. ([source](https://hexo.io/docs/configuration))
- [Asset Pipelines](https://awesome-repositories.com/f/content-management-publishing/asset-pipelines.md) — Manages static assets by automatically processing and including stylesheets and scripts in the build output. ([source](https://hexo.io/docs/themes))
- [Content Scaffolding](https://awesome-repositories.com/f/content-management-publishing/content-scaffolding.md) — Defines custom file templates to standardize the structure of new posts. ([source](https://hexo.io/docs/writing))
- [Drafting Workflows](https://awesome-repositories.com/f/content-management-publishing/drafting-workflows.md) — Manages draft posts in a dedicated folder with tools for publishing. ([source](https://hexo.io/docs/writing))
- [Layout Engines](https://awesome-repositories.com/f/content-management-publishing/layout-engines.md) — Allows assigning specific layouts to content files to determine processing behavior. ([source](https://hexo.io/docs/writing))
- [Metadata Schemas](https://awesome-repositories.com/f/content-management-publishing/metadata-schemas.md) — Uses YAML blocks at the top of files to define page-specific variables and layout properties.
- [Pagination Managers](https://awesome-repositories.com/f/content-management-publishing/pagination-managers.md) — Defines post counts per page and URL formats for paginated content. ([source](https://hexo.io/docs/configuration))
- [Site Component Helpers](https://awesome-repositories.com/f/content-management-publishing/site-component-helpers.md) — Renders pagination controls, search forms, and tables of contents. ([source](https://hexo.io/docs/helpers))
- [Syntax Highlighting Configurations](https://awesome-repositories.com/f/content-management-publishing/syntax-highlighting-configurations.md) — Configures syntax highlighting engines to render code blocks with line numbering and language-specific formatting. ([source](https://hexo.io/docs/syntax-highlight))
- [Syntax Highlighting Engines](https://awesome-repositories.com/f/content-management-publishing/syntax-highlighting-engines.md) — Integrates syntax highlighting engines to process code blocks with language detection. ([source](https://hexo.io/docs/syntax-highlight))

### Web Development

- [Static Site Generators](https://awesome-repositories.com/f/web-development/static-site-generators.md) — Converts markdown and text files into high-performance static websites.

### Development Tools & Productivity

- [Development Servers](https://awesome-repositories.com/f/development-tools-productivity/development-servers.md) — Launches a local development server to preview the website with configurable options. ([source](https://hexo.io/docs/commands))
- [File Watchers](https://awesome-repositories.com/f/development-tools-productivity/file-watchers.md) — Watches source files for modifications and automatically regenerates output files. ([source](https://hexo.io/docs/generating))

### Software Engineering & Architecture

- [Extensible Architectures](https://awesome-repositories.com/f/software-engineering-architecture/extensible-architectures.md) — Features a modular ecosystem for adding custom functionality via plugins.
- [Build Pipelines](https://awesome-repositories.com/f/software-engineering-architecture/build-pipelines.md) — Provides a lifecycle-based execution model that triggers hooks for file processing, asset generation, and deployment tasks.
- [Plugin Systems](https://awesome-repositories.com/f/software-engineering-architecture/plugin-systems.md) — Supports developing distributable extensions via a structured package system. ([source](https://hexo.io/docs/plugins))
- [Plugin Architectures](https://awesome-repositories.com/f/software-engineering-architecture/plugin-architectures.md) — Loads external packages to add custom rendering engines, deployment strategies, and site-wide functionality.

### User Interface & Experience

- [Layout Engines](https://awesome-repositories.com/f/user-interface-experience/layout-engines.md) — Injects content into reusable wrapper files to maintain consistent site structure.
- [Template Engines](https://awesome-repositories.com/f/user-interface-experience/template-engines.md) — Separates site content from visual presentation through configurable layouts and partials.
- [Theme Engines](https://awesome-repositories.com/f/user-interface-experience/theme-engines.md) — Uses template engines to control the visual presentation of generated pages.

### DevOps & Infrastructure

- [Deployment Automation](https://awesome-repositories.com/f/devops-infrastructure/deployment-automation.md) — Includes a built-in workflow for synchronizing site files to hosting providers.
- [Deployment Integrations](https://awesome-repositories.com/f/devops-infrastructure/deployment-integrations.md) — Deploys static websites to various hosting services via configuration. ([source](https://hexo.io/docs/github-pages))
- [Deployment Pipelines](https://awesome-repositories.com/f/devops-infrastructure/deployment-pipelines.md) — Integrates website generation with remote hosting for automated publishing.
- [CDN Deployment Integrations](https://awesome-repositories.com/f/devops-infrastructure/cdn-deployment-integrations.md) — Deploys sites to global CDNs using automated build and sync workflows. ([source](https://hexo.io/docs/one-command-deployment))
- [Edge Network Deployment](https://awesome-repositories.com/f/devops-infrastructure/edge-network-deployment.md) — Integrates with cloud platforms for automated edge network delivery. ([source](https://hexo.io/docs/one-command-deployment))
- [Git Deployment Integrations](https://awesome-repositories.com/f/devops-infrastructure/git-deployment-integrations.md) — Deploys site files to remote Git repositories for version-controlled hosting. ([source](https://hexo.io/docs/one-command-deployment))

### Data & Databases

- [Markdown Asset Handlers](https://awesome-repositories.com/f/data-databases/markdown-asset-handlers.md) — Automatically resolves image paths to post-specific folders for direct linking. ([source](https://hexo.io/docs/asset-folders))
- [Scoped Asset Directories](https://awesome-repositories.com/f/data-databases/scoped-asset-directories.md) — Enables dedicated folders for individual posts to store related assets. ([source](https://hexo.io/docs/asset-folders))