About Themes

by typora.io

Change Themes

Typora has 6 built-in themes, which can be selected using under the Themes menu in the menu bar. You can also download, install, modify or write your own custom theme to stylize Typora.

Typora uses CSS to style everything. Each theme shown in the Themes menu is one .css file under “Typora’s theme folder”. So you can add/modify themes by adding/modifying corresponding css files under “Typora’s theme folder”.

Use Themes Under Light Mode and Dark Mode

You can set separate themes for light mode and dark mode (on macOS / Windows). When the system’s color scheme changed, the corresponvsinf theme you chose will be applied.

Screen Shot 2020-12-05 at 17.01.49

Your theme can also use media query for prefers color scheme to write a responsive theme for both light mode and dark mode.

Naming Rule

When writing your own theme, you need to use this file naming rule for theme css: do not use capitalized letters, and nonalphabet characters except -. Replace any whitespace with -, and Typora will convert them to a readable label in menu item. For example, for my-first-typora-theme.css, Typora will show “My First Typora Theme” under the “Themes” menu.

Get Typora Themes

We have an official website Typora Theme Gallery for designers/developers to share their custom themes with others. You can download themes from there.

Screen Shot 2020-12-05 at 22.09.28

Custom Themes Installation

  1. Open Theme Folder. (see instructions below)
  2. Copy or move .css file and related resources, like fonts or images, into the newly opened folder.
  3. Restart Typora, then select it from Themes menu.

Open Theme Folder

macOS

Open the preference panel and click “Open Theme Folder” button.

typora-preference-mac

On macOS, usually it is /Users/{username}/Library/Application Support/abnerworks.Typora/themes/.

Windows/Linux

Open preference panel from FilePreference from menubar, then click “Open Theme Folder”:

typora-preference-electron

Modify Current Styles

Sometimes you may just want to change font family for all themes, or change font color for headings for specific themes. In this case, you do not need to copy/modify a whole exiting css file, instead Add Custom CSS is enough.

Writing My Own Theme

Please see Write Custom Theme for Typora.