Open a theme in this gallery and click Install. Typora opens Settings ▸ Extensions and asks before installing it.

Or click Download and open the .typora-theme file. Typora opens Settings ▸ View, installs it once you agree and switches to it.

Choose an installed theme in Settings ▸ View or in the Themes menu. Uninstall it from Settings ▸ Extensions.

A theme is a folder with a theme.toml: variables for fonts, sizes and colours, then element styles for headings, quotes, code and tables.

Save it under Themes/ in the folder that Settings ▸ View ▸ Open Folder shows, and choose it. Typora reloads it when you switch back to the app.

Add a theme.css only for decoration theme.toml cannot express.

Fork typora/typora-extensions on GitHub.

Add your theme as themes/<your.id>/: a typora-extension.json that contributes only themes, with the tag Theme, and the theme folders it names.

Add cover.webp (500 × 400) and screenshot.webp (1760 × 1100), Typora showing the theme.

Run npm run validate, then open a pull request. CI packages what was reviewed as <your.id>-<version>.typora-theme.

Themes on theme.typora.io are written for Typora 1 and do not work in Typora 2.0. The themes Typora made have been rebuilt here.

To bring another one along, give its link to the chat in Typora and ask for it to be installed, or convert it by hand.

Hosted on GitHub. Every theme here is reviewed and built from source by Typora's CI.

Contact hi@typora.io.