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 %}