https://github.com/sindresorhus/github-markdown-css

The minimal amount of CSS to replicate the GitHub Markdown style
https://github.com/sindresorhus/github-markdown-css

Last synced: 5 days ago
JSON representation

The minimal amount of CSS to replicate the GitHub Markdown style

• Host: GitHub
• URL: https://github.com/sindresorhus/github-markdown-css
• Owner: sindresorhus
• License: mit
• Created: 2014-05-07T18:03:02.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2024-04-14T00:34:41.000Z (7 months ago)
• Last Synced: 2024-05-22T20:33:04.207Z (6 months ago)
• Language: CSS
• Homepage: https://sindresorhus.com/github-markdown-css
• Size: 375 KB
• Stars: 7,713
• Watchers: 90
• Forks: 2,114
• Open Issues: 14
• Metadata Files:
  • Readme: readme.md
  • License: license
  • Security: .github/security.md

Awesome Lists containing this project

• stars - sindresorhus/github-markdown-css
• awesome - sindresorhus/github-markdown-css - The minimal amount of CSS to replicate the GitHub Markdown style (CSS)
• favorite-link - 复制 GitHub Markdown 样式的最小 CSS 量。
• awesome-starred-test - sindresorhus/github-markdown-css - The minimal amount of CSS to replicate the GitHub Markdown style (CSS)
• awesome - sindresorhus/github-markdown-css - The minimal amount of CSS to replicate the GitHub Markdown style (CSS)
• awesome-github-star - github-markdown-css
• awesome-web-editor - github-markdown-css - The minimal amount of CSS to replicate the GitHub Markdown style. (Other)
• awesome - sindresorhus/github-markdown-css - The minimal amount of CSS to replicate the GitHub Markdown style (CSS)
• awesome - sindresorhus/github-markdown-css - The minimal amount of CSS to replicate the GitHub Markdown style (CSS)

README

        
# github-markdown-css

> The minimal amount of CSS to replicate the GitHub Markdown style

**The CSS is generated. Contributions should go to [this repo](https://github.com/sindresorhus/generate-github-markdown-css).**

[](http://sindresorhus.com/github-markdown-css)

## [Demo](https://sindresorhus.com/github-markdown-css)

## Install

Download [manually](https://raw.githubusercontent.com/sindresorhus/github-markdown-css/gh-pages/github-markdown.css), from [CDNJS](https://cdnjs.com/libraries/github-markdown-css), or with npm:

```sh

npm install github-markdown-css

```

## Usage

Import the `github-markdown.css` file and add a `markdown-body` class to the container of your rendered Markdown and set a width for it. GitHub uses `980px` width and `45px` padding, and `15px` padding for mobile.

```html

	.markdown-body {

		box-sizing: border-box;

		min-width: 200px;

		max-width: 980px;

		margin: 0 auto;

		padding: 45px;

	}

	@media (max-width: 767px) {

		.markdown-body {

			padding: 15px;

		}

	}

	
Unicorns

	
All the things


```

You can use [GitHub's `/markdown` API](https://docs.github.com/en/free-pro-team@latest/rest/reference/markdown) to turn Markdown into the HTML that GitHub generates, which works well with the CSS in this repo. Other Markdown parsers will mostly work with these styles too. To mimic how GitHub highlights code, you can use [`starry-night`](https://github.com/wooorm/starry-night) with your Markdown parser of choice.

There are 3 themes provided in this package:

- **github-markdown.css**: (default) Automatically switches between light and dark through [`@media (prefers-color-scheme)`](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme).

- **github-markdown-light.css**: Light-only.

- **github-markdown-dark.css**: Dark-only.

You may know that now GitHub supports more than 2 themes including `dark_dimmed`, `dark_high_contrast` and `colorblind` variants. If you want to try these themes, you can generate them on your own! See next section.

## How

See [`generate-github-markdown-css`](https://github.com/sindresorhus/generate-github-markdown-css) for how it's generated and ability to generate your own.

## Dev

Run `npm run make` to update the CSS.