# Code Hike

Build rich content websites with Markdown and React

Repository: https://github.com/code-hike/codehike
Canonical: https://ross.abutalabs.com/products/code-hike
Homepage: https://codehike.org
Language: TypeScript
License: MIT
License Family: permissive
Topics: blog, code, docs, javascript, markdown, mdx, react, scrollytelling, syntax-highlighting
Last push: 2026-03-17T09:09:59+00:00
Link (homepage): https://codehike.org
Link (site_page): https://codehike.org/docs
Link (site_page): https://codehike.org/docs/concepts/annotations
Link (site_page): https://codehike.org/docs/code

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 72, release rhythm 63, longevity 100
- inputs: {"age_days": 2323, "days_push": 169, "days_rel": 169, "gap_med": 34.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5376, forks 167 (observed 2026-08-28T04:09:16.191264+00:00)

## What it is
Code Hike is an open-source TypeScript library that bridges Markdown/MDX and React, letting authors build rich content websites with structured, type-safe markdown and headless, customizable code blocks. It provides annotation handlers, syntax highlighting, and layouts like scrollycoding for tutorials, docs, and blogs.

## Use cases
- build documentation sites with markdown and react
- create interactive code walkthroughs and tutorials
- add syntax-highlighted code blocks with custom components to mdx
- build scrollytelling blog posts and landing pages
- separate content authoring from presentation in a docs design system
- write type-safe structured markdown content

## When to choose
- you write technical content (docs, tutorials, blogs) in markdown but want full React control over rendering
- you need rich, annotated code blocks with focus, diffs, copy buttons, or token transitions
- a team separates docs design from content authoring and wants type-safe structured markdown

## When to avoid
- you need a turnkey docs site with prebuilt UI rather than headless components you assemble yourself
- your stack is not React/JavaScript-based
- you only need simple static markdown rendering without custom code blocks

## Facets
- artifact type: library
- maturity: active
- function: markdown, templating, ui-components, developer-tools, documentation
- domain: web-development, frontend, documentation, developer-tools
- platform: cross-platform
- tags: mdx, react, syntax-highlighting, scrollytelling, code-blocks, content-sites, type-safe-markdown, nextjs, nodejs, web-server

## Member repositories
- code-hike/codehike (main) score 74
- code-hike/bright (plugin) score 34

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:16.191264+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:58:41.430531+00:00, confidence not recorded.
  - readme: https://github.com/code-hike/codehike (fetched 2026-08-28T04:09:16.191264+00:00, sha 300fd0660fc2)
  - homepage: https://codehike.org (fetched 2026-08-29T08:53:28.392294+00:00, sha d350ed39684d)
  - site_page: https://codehike.org/docs (fetched 2026-08-29T08:53:28.401373+00:00, sha ee2320f7f15c)
  - site_page: https://codehike.org/docs/concepts/annotations (fetched 2026-08-29T08:53:28.403564+00:00, sha bbaa8ca86ae2)
  - site_page: https://codehike.org/docs/code (fetched 2026-08-29T08:53:28.405434+00:00, sha 2677b4002d86)
  - registry_npm: https://registry.npmjs.org/codehike (fetched 2026-08-29T08:53:28.407173+00:00, sha 7f5fcb51e87e)
  - registry_npm: https://registry.npmjs.org/bright (fetched 2026-08-29T08:53:28.408729+00:00, sha dd89113a78c2)
- Data as of 2026-08-30T08:39:29.467469+00:00.