Skip to content

expressive-code/expressive-code

Repository files navigation

Expressive Code

Expressive Code is an engine for presenting source code on the web, aiming to make your code easy to understand and visually stunning.

On top of accurate syntax highlighting powered by the same engine as VS Code, Expressive Code allows you to annotate code blocks using text markers, diff highlighting, code editor & terminal window frames, and more.

All annotations are based on a powerful plugin architecture that allows you to extend the functionality of Expressive Code with your own custom annotations.

Expressive Code doesn't depend on any client-side framework, is built with performance in mind and designed to be as lightweight as possible.

No matter if you’re writing a blog, guide, or a full documentation website, Expressive Code will help you make your code examples stand out.

Documentation

Read the Expressive Code docs to learn more about the features provided by Expressive Code, which framework integrations are available, and how to use them.

About this repository

This is a monorepo that contains all packages related to Expressive Code. Click on any of the packages below to jump to the respective subfolder.

High-level integration packages

  • rehype-expressive-code NPM version - A rehype plugin that processes all code blocks in markdown and MDX files with Expressive Code.
  • astro-expressive-code NPM version - An Astro integration to automatically render code blocks in any markdown / MDX content on your site with Expressive Code. It also provides a <Code> component to render dynamic code blocks.

Default plugins

Additional plugins

Low-level packages for integration authors

  • expressive-code NPM version - This bundle package provides convenient access to the Expressive Code core engine and all default plugins.
  • @expressive-code/core - The core engine that powers Expressive Code.

Installation, Configuration & Usage

Read the installation instructions to learn how to install Expressive Code.

Contributing

We welcome all contributions! Please read our contributing guide to learn about our development process and how to propose bugfixes and improvements.