Skip to content
Read Medium stories with happy eyes!
JavaScript CSS HTML
Branch: master
Clone or download
Latest commit 0241879 Aug 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Readme: Add more details Oct 11, 2017
build Usercss: Add `@updateURL` May 5, 2019
icons Initial commit Oct 7, 2017
images Readme: Cleanup option screenshot Feb 4, 2018
js Meta: Fix update & linting issues Oct 20, 2018
options Add hide footer option Feb 2, 2018
.editorconfig Initial commit Oct 7, 2017
.eslintignore Prettify: Use unminified version to appease AMO Mar 22, 2018
.gitattributes Initial commit Oct 7, 2017
.gitignore Build: Add usercss generation Oct 10, 2017
.stylelintrc.json Initial commit Oct 7, 2017 Initial commit Oct 7, 2017 Final update? Aug 15, 2019
darker-medium-extras.user.css Usercss: Add extra usercss. See #10 & #11 May 5, 2019
darker-medium.user.css Usercss: Add `@updateURL` May 5, 2019
gist.css Add Gist snippet styling Feb 4, 2018
manifest.json 1.4.4 May 5, 2019
package.json 1.4.4 May 5, 2019
style-profiles.css UserCSS: Only target profile pages Nov 14, 2018
style.css Add white background to images. Fixes #9 Nov 13, 2018


Medium has completely changed their CSS framework, so this extension and the userstyle won't work any more.

The previous framework used desriptive class names like "u-backgroundBlueGrey"; but now everything is one to two letters long, e.g. "a b c"

I don't have the time, nor the patience to decrypt that mess. 😿

Darker Medium tags devDependency Status

Read Medium stories with happy eyes!




  • Applies a customizable dark theme to all medium formatted stories.
  • Customize:
    • Header background.
    • Main Accent color.
    • Highlighting color.
    • Link color, hover and underline.
    • Hiding the "get updates" footer.
  • Adds syntax highlighting to code and styles embedded gists.
  • Medium story sites are automatically detected and styled.
  • The advantage of using this extension over Stylus or Stylish is that you install it, customize it and forget about it.
  • Please see this wiki page for a list of sites that were tested for this extension.
  • A user.css file is available, and once Stylus has implemented support for user.css files, it will be immediately usable and installable from this repository.

Security Concerns

This browser extension does not collect any personal data.

The only data stored is the user style preferences (the state of the extension, five colors & an underline setting). Absolutely nothing else is shared or tracked; not even Google Analytics.


Apologizes to the sites that use specific colors in their branding, this extension overrides all of your colors; and it definitely doesn't touch your logo!

For example, I love, but your bright green header and banners make my eyes scream when I try to read your site at night. This web extension applies an overall dark theme to all sites including those bright headers.



Install it for:


Stylus supports user.css file formats. When a "raw" version of darker-medium.user.css from this repository (link below) is opened in the browser, Stylus will prompt you to install the style. For more details, see the usercss documentation.

Install the main usercss

Install the extras usercss ( profile & topic page styling)

The advantages of using a usercss are as follows:

  • No intermediary domain is needed to host the usercss file.
  • Updates will be immediately available.
  • Style customization is built-in. The same customizations for the extension are also available.

The disadvantage of this specific usercss is:

  • Syntax highlighting is not applied to code snippets, because it requires JavaScript processing.
  • Medium stories on unlisted domains will not be styled. If you want to report an unstyled Medium domain, please look in the other issues section for more details. A list of currently supported sites can be found in the medium-sites.js file.

NOTE: The version number of the available web extension may lag behind the usercss because the usercss style needs updating to add more sites, while the web extension will detect them automatically.


Toggle the style (temporarily)

Click on the Darker Medium icon to toggle the dark style on and off temporarily for the visible page. This state is not stored; this may be added in a future update.

Toggle Darker

Customize accent colors

Open the Extension options (all settings are stored):

  • Enabled - This is a global toggle of the Darker Medium extension.
  • Header - Customize the background color of the page header.
  • Main - Customize the main accent color. This is overrides the branded color of the site.
  • Highlight - Customize the highlighted text background color. The text color is automatically adjusted as needed.
  • Link Color - Customize all link colors. This may include icons as well as links within the article.
  • Link Hover - Customize the link hover color.
  • Include link underline - Include or hide link underlines.
  • Hide Footer - Show or Hide the signup/get updates footer.
  • Reset - Restore the default settings.



If you would like to contribute to this repository, please refer to the contribution guidelines.

And don't worry if you've never contributed to an open-source project before, you can start by reading this friendly guide.

This project is bound by a Code of Conduct.

Reporting problems


Style issues

  • The profile & topic pages of do not use the same css framework as the main stories pages. To make these pages dark, install the darker-medium-extras.user.css usercss style linked above (Stylus is needed).
  • If it's a public page, you'll only need to report the URL and any steps needed to show the problematic area.
  • If you need a membership to access the page, then please include the HTML and related CSS:
    • First, you'll need to right click on top of the element, and select "Inspect" or "Inspect Element".
    • The Developer Tools panel will open.
    • Make sure the highlighted element and the element above it are visible in the panel.
    • Look to the right side of that panel and you should find the "Styles" (or "Rules") tab.
    • Now look for the problematic style (usually a background-color or color).
    • Share the HTML/CSS by either:
  • If these instructions aren't clear enough, or you want to contact a person, use Gitter (click the button above) for this repository.

Other issues

  • Please report:
    • If public, and pertinent, please share the URL of the page with the problem.
    • Report any javascript error as seen in the development tools console (Press F12 to open it).
    • Any extra information as described in the issue template when a new issue is opened.
  • Do you know how to solve it? It'd be awesome if you contributed a fix!
You can’t perform that action at this time.