# What's New in Retype v3.9

By

@geoffreymcgill

●

In 

release

●

Published 2025-05-28

Retype v3.9 brings improvements to callout components, broader syntax features to support other systems, enhanced image handling, and better print functionality. This release focuses on making Retype more compatible with other documentation platforms while adding powerful new features.

Meet the new question callout variant, perfect for FAQ sections, troubleshooting guides, or any content that poses questions to readers. See docs.

!!!question Common Question
How do I configure my documentation site?
!!!

The question callout features a distinctive question mark icon and styling that makes it stand out from other callout types.

Set image dimensions using intuitive pipe separated syntax. See docs.

You can add a custom width or width x height:

![Sample Image|300](/static/sample.jpg)
![Sample Image|300x200](/static/sample.jpg)

This syntax is cleaner than adding generic attributes and works seamlessly with Retype's image processing.

Generic attributes on images are still supported and provide an alternative syntax for adding a custom id, CSS class, dimensions, or any custom attributes:

![My image](image.jpg){.custom-css-class}
![My image](image.jpg){#custom-id}
![My image](image.jpg){#custom-id width="300"}

Retype now includes a comprehensive print stylesheet that help makes your documentation look great printed to PDF or paper.

Clean Layout

Removes navigation, sidebars, and interactive elements

Optimised Typography

Adjusts fonts and spacing for print readability

Smart Page Breaks

Prevents awkward breaks in code blocks and tables

URL Display

Shows full URLs for external links in print

High Contrast

Ensures text is readable in black and white

Simply use the browser's print function Ctrl + p or ⌘ + p to get professional printed results.

Adjust your left sidebar navigation visual appearance with the new nav.icons setting. See docs.

nav:
  icons:
    mode: folders  # Options: all, folders, pages, top, none

This is particularly useful for documentation sites that prefer a cleaner, text-focused navigation.

Set your project's default color scheme with the new scheme configuration. See docs.

The scheme configuration allows you to control the default color mode (light or dark) for your Retype generated website. By default, Retype will automatically match the visitor's system preference, but now you can explicitly set the site to start in either dark or light mode.

Add the following to your retype.yml file:

scheme:
  mode: dark  # Options: system, dark, light

The new scheme setting gives you control over the initial appearance while still allowing users to switch themes to match their preference.

With universal callout syntax support, migrating from other documentation platforms is now seamless. Whether you're upgrading from Notion, GitHub, Obsidian, or any other platform, your existing callouts will work immediately in Retype.

The enhanced image syntax and print support make Retype suitable for both digital and print documentation workflows, while the navigation customization options let you create the exact look you want.

This release represents a major step forward in making Retype the most compatible and feature-rich documentation platform available. We're continuing to expand platform compatibility and add new features based on your feedback.

Try out v3.9 and experiment with the new features, then let us know what you think on X or by opening a GitHub Issue. Your input helps shape the future of Retype.