Table of contents

  1. Color schemes
  2. Specific visual customization

Color schemes


Just the Docs supports two color schemes: light (default), and dark.

To enable a color scheme, set the color_scheme parameter in your site’s _config.yml file:


# Color scheme currently only supports "dark" or nil (default)
color_scheme: "dark"

Specific visual customization

To customize your site’s aesthetic, open _sass/custom/custom.scss in your editor to see if there is a variable that you can override. Most styles like fonts, colors, spacing, etc. are derived from these variables. To override a specific variable, uncomment its line and change its value.

For example, to change the link color from the purple default to blue, open _sass/custom/custom.css and find the $link-color variable on line 50. Uncomment it, and change its value to our $blue-000 variable, or another shade of your choosing.


// ...
// $body-text-color: $grey-dk-100;
// $body-heading-color: $grey-dk-300;
$link-color: $blue-000;
// ...

Note: Editing the variables directly in _sass/support/variables.scss is not recommended and can cause other dependencies to fail.