Fonts

Created on January 18, 2023 — updated on November 8, 2026


Changing the fonts

Site name style

  • Default: normal
theme:
  site_name_style: normal

Title style

  • Default: bold
theme:
  title_style: bold

Remote fonts and icons

By default the theme loads Fira Mono from Google Fonts and FontAwesome 4.7 from cdnjs. Highlight.js, when enabled, is loaded from cdnjs and unpkg.

  • Default: true
theme:
  remote_assets: true

Set remote_assets: false to stop every request to these third-party servers. Text falls back to the browser's monospace font, FontAwesome icons are not rendered and Highlight.js is skipped even if highlightjs is true. The repository widget hides its shields.io badges (tag, stars, forks), and the header search button switches to a built-in SVG icon so search stays reachable.

theme:
  remote_assets: false

Serving your own copies

The font and icon stylesheets live in their own fonts and icons template blocks, so you can replace them without copying the rest of the theme. Put the files under docs/ and override the blocks from a custom_dir:

theme:
  name: simple-blog
  custom_dir: overrides
{# overrides/main.html #}
{% extends "base.html" %}

{% block fonts %}
<link rel="stylesheet" href="{{ 'assets/fonts/fira-mono.css'|url }}">
{% endblock %}

{% block icons %}
<link rel="stylesheet" href="{{ 'assets/font-awesome/css/font-awesome.min.css'|url }}">
{% endblock %}