Home / GitHub Page

Configurable themes?


Hi. I’m using the “Dark” theme with Joplin but I don’t like it as much as the “Dark” themes from other softwares I am using.

It is possible to add some adjustment option for the themes? Maybe some sort of .css themes so to be able to change the colours as I need?


Currently there’s no way of adding themes by just creating a theme directory in the config dir.

However, you can still have a look at the PR for the dark theme and create an additional theme and make it available to everyone. But check with @laurent first, if he even wants an additional theme. I think he’d be more interested in a theme plugin manager system, which works across all clients.

Or, there’s a also the possibility of using a custom css file:

Custom CSS

Rendered markdown can be customized by placing a userstyle file in the profile directory ~/.config/joplin/userstyle.css. This file supports standard css syntax.


Hi tessus and thank you for reply.

I am using the portable windows version right now, so I do created a new file like this: “JoplinProfile/userstyle.css”

I edited the css file as follows:

color: #FFFFFF;
text-decoration: none;
a:visited {
color: green;…


but nothing happens. I want to remove the underline of the links.

What it is wrong?


The CSS file is only loaded on startup, did you restart the editor after creating the file?
It’s also possible that it’s been created in the wrong location, you can double check that.



This is the location. Switched from the portable version to normal one.

I restarted Joplin but nothing happens.


I think you meant


Anyway, is it possible that when you close Joplin and re-open, it’s not actually stopping the application? I.e. is it only closing to the clip tray? The application needs to be completely stopped.


I restarted the computer a few times since created the userstyle.css file. Nothing changed.

The correct path to the file:


Oops I just noticed I had a typo in the path, but it looks like yours is correct.

I installed joplin on a windows computer to test this and the userstyle.css file worked correctly with the path you specified, but not with the css you provided. I’m not an expert on css but I think the a:visited doesn’t work with userstyle.css, perhaps because userstyle stuff is basically inline, or it could have to do with the renderer joplin uses.
That said, you can still customize links, but it looks like you have an issue with your css, there should not be a colon after the ‘a’ i.e.

a {
    color: #FFFFFF;
    text-decoration: none;

This worked on my computer, but what you have above didn’t.


Yes, indeed, this way it is working. Thank you.