Skip to content

KraXen72/obsidian-painter

Repository files navigation

Painter

Obsidian plugin

Paint text different colors

minimal-menu
normal-menu
commands

Inspired by my css snippet & data.json to use Highlightr to change text color.
The aim of this plugin is to support most features of Highlightr-Plugin as well as changing of the text color.

Improvements over original plugin

New features

  • Added text-color higlight option
  • Added minimal menu style - only show icons in one line (with title attributes)
  • Smarter selection (adapted from Smarter MD Hotkeys)
    • Inline code signifies the part of the text being selected. | is a cursor without selection.
    • Auto-select word: "hello t|here world!" => "hello there world!"
    • Trim selection to nearest word: "what is up?" => "what is up?"
    • You are still able to paint a certain part of a word: "hello" => "hello"
  • Better Clear (formerly Remove higlight) command
    • Added it to the highlighting menu as well
    • In settings, you can configure custom CSS selectors to remove alongside any mark elements
    • Replaced regex-based approach with a DOMParser
  • New svg icon (modified lucide highlighter icon)
  • Added dynamic highlight preview in settings (shows with your colors)

Fixes

Other

  • Cleaned up file structure & move to esbuild instead of rollup
  • Removed a bunch of unnecessary code & styles, overall cleanup & rewrite
    • Removed a bunch of custom icons in favor of normal obsidian icons
    • Removed wait() calls (promise + settimeout)
  • Removed dependencies:
    • pickr - Replaced with obsidian's native color picker & an alpha slider
  • Renamed command ids for consistency
  • Rewrote basically the entire plugin lol
  • added "use strict" to minified code to improve performance

Support plugin development

If you find this Plugin helpful, consider it's further development or just say a small thank you
liberapay kofi

Migrating from highlightr

If you've previously used the highlightr plugin, you can migrate your settings by copying:

  • <vault>/.obsidian/plugins/highlightr-plugin/data.json =>
  • <vault>/.obsidian/plugins/painter/data.json

Then, disable & enable the Painter plugin. Make sure to check settings have sucessfully migrated, and if they have, feel free to uninstall highlightr.

css-classes vs. inline-styles: which should you choose?

The settings allow you to select between two highlight styles, css-classes and inline-styles. Here is their comparison:

css-classes

  • Uses <mark class="hltr-colorname">content</mark>
  • Painter plugin injects a stylesheet which colors these
  • 👍 More flexible:
    • Re-defining a color with the same name will update existing highlights
    • Changing the highlight style will update all existing highlights as well

Unless you plan on frequently exporting your notes outside of obsidian, use Obsidian Publish or edit notes in externally, pick this option. It's much more flexible. Even if you plan to someday export your notes, you can always write a simple script to convert the <mark> elements to whatever you want, or add a custom stylesheet that will add back their coloring.
In a future plugin release, there will likely be an option to generate this stylesheet for usage outside of obsidian.

inline-styles

  • uses <mark style="color:#hex">content</mark> or <mark style="background-color:#hex">content</mark>
  • still dependent on obsidian/external stylesheets for any other styling, like rounded corners, padding, etc.
  • bakes the color in the highlight: if you change a color in settings, previous highlights will stay the same
  • changing highlight style later will not fully affect existing highlights
    • background-color highlights will not turn into color (text-color in settings) and vice versa.
  • slightly easier to use outside of obsidian

Some people might prefer this method, so i kept it in.
Feel free to experiment with them to find the one best for your use-case.

i can't see the color previews in context menu

menu
If your context menu looks like this and not like the one in the screenshots above, in Obsidian settings, Appearance > Advanced, turn off Native menus.

Credits

What this plugin doesen't try to be

This plugin is for coloring/highlighting text.
It doesen't try to provide a comprehensive formatting toolbar/experience. Out of scope: Modal highlighting (highlighting brushes)
Use this: obsidian-editing-toolbar