Skip to content

rehype plugins that match how GitHub transforms markdown on their site

License

Notifications You must be signed in to change notification settings

rehypejs/rehype-github

Repository files navigation

rehype-github

Build Coverage Sponsors Backers Chat

rehype plugins that match how GitHub transforms markdown on their site.

👉 Note: Not yet released, currently being worked on.

Contents

What is this?

This project is a monorepo that contains many packages that can be used together or on their own, with defaults to match GitHub or with configuration to match your site, to process user content for safe use on the web.

When should I use this?

You can use these tools when you need to:

  1. match GitHub in how it transforms markdown to HTML
  2. build similar pipelines to bring user content to the masses

Install

Currently, install and use each package manually.

Packages

GitHub additionally includes client side code to enhance certain code blocks by evaluating their contents. This behavior is performed by:

See example/viewscreen/ on how to use them together.

To do:

  • Change some things in hast-util-to-mdast to match current things that GitHub does there
  • Investigate task lists
  • Investigate port of treelights
  • Investigate linking to labels, issues, pulls, files, lines in files,

Examples

Example: To do

Types

These packages are fully typed with TypeScript.

Compatibility

Projects maintained by the unified collective are compatible with all maintained versions of Node.js. As of now, that is Node.js 16.0+. Our projects sometimes work with older versions, but this is not guaranteed.

Security

To do.

Related

Contribute

See contributing.md in rehypejs/.github for ways to get started. See support.md for ways to get help.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.

Notice

This project is not affiliated with GitHub.

License

MIT © Titus Wormer