Visual Kit

by Pedro Henrique Francisco
5
4
3
2
1
Score: 50/100

Description

A plugin for Obsidian. Mainly focused on improving the workflow with images

Reviews

No reviews yet.

Stats

0
stars
196
downloads
0
forks
26
days
5
days
5
days
1
total PRs
0
open PRs
1
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
21
commits

Latest Version

6 days ago

Changelog

Visual Kit 0.9.1 — HTML editor improvements

  • Use icons for common formatting actions and group additional controls under More formatting, Table, and Image.
  • Save HTML notes as templates from the note toolbar or the file explorer context menu.
  • Drag the bottom-right handle of a selected image to resize it proportionally.
  • Preserve merged cells and translate Movidesk-style dashed borders and alternating rows when pasting tables. Leave space to type after a table pasted at the end.
  • Verify that rich clipboard output embeds multiple images in both compatibility modes. Saving the pasted images in Movidesk requires a signed-in ticket test.

Visual Kit 0.9.0 — HTML templates and richer formatting

  • Add unlimited vault-based HTML templates and a template dropdown to note creation. Save the active HTML note as a template through the command palette.
  • Preserve relative image references when saving templates and creating notes from them.
  • Expand visual formatting with semantic HTML, flex/grid, shadows, rounded corners and typography controls. Render embedded stylesheets in an isolated full-document Preview.
  • Refresh toolbar spacing, controls and active-mode indicators; add subscript, superscript, clear formatting and heading levels 5–6.

Visual Kit 0.8.6 — Paste into the current HTML note

  • Paste text and formatted HTML directly into the current note without creating a clipboard-original file or requiring a backup confirmation.
  • Sanitize pasted content and report removed formatting while preserving existing files' source-protection behavior.
  • Skip asynchronous attachment work for text-only HTML pastes. Add native Chromium clipboard regression checks for copying and pasting aaaaaa, browser-generated formatting and sanitized HTML.

Visual Kit 0.8.5 — Quick HTML note creation

  • Add Add HTML note beside the file explorer's New note action.
  • Focus and select the note name immediately; press Enter to create from the explorer, command palette or folder menu. The .html extension is added automatically.
  • Accept Obsidian's vault-root folder when creating HTML notes, fixing the misleading Image folder must be relative to the vault error.

Visual Kit 0.8.4 — Obsidian review fixes

  • Use Obsidian DOM helpers to create empty elements, adopting them into the target inactive or sandbox document before adding content.
  • Apply serialized table borders and proportional image sizing through the host setCssStyles helper, including elements from isolated documents.
  • Remove broad HTML-note lint exclusions so the standard DOM-helper and static-style rules run locally and in release CI.
  • Wait for the Preview iframe body before asserting its text in browser tests. Version 0.8.3 was not published because this test raced frame initialization in CI.
  • Retain creator credit and README artwork.

Vault enumeration supports attachment deduplication; clipboard access supports paste and rich copy. These are expected capabilities. The existing execCommand adapter remains deprecated and covered by browser integration tests. External review results require a new review run.

Visual Kit 0.8.2 — Creator credit and refreshed overview

  • Correct the plugin creator to pedrof, with a link to the creator's GitHub profile. The plugin remains Visual Kit with the same plugin ID and settings.
  • Replace the README overview with a sharper seven-feature illustration covering screenshot tools and HTML notes. Include editable SVG artwork and a reproducible PNG generator.
  • Update the README introduction, author credit and quick starts for Markdown and HTML notes. Clarify selection copy versus explicit whole-note copy.

Update Visual Kit and reload Obsidian to refresh the installed author metadata.

HTML notes, introduced in 0.8.1

Create real .html notes in your vault and exchange formatted responses with ticket systems, email clients and other rich-text editors.

  • Create notes from the command palette or a folder menu, with safe filename collision handling.
  • Edit visually with font/color/highlight controls, alignment, lists, links, separators, tables and images. Switch to syntax-highlighted Source or read-only Preview without losing content.
  • Autosave locally, or use Save / Ctrl+S / Cmd+S. Unedited files remain byte-identical. External changes stop conflicting writes and offer reload, source resolution or a recovery copy.
  • Paste rich HTML and images in order using existing attachment folders, naming, validation and deduplication. Resize display dimensions and reuse the annotation editor through an HTML adapter.
  • Copy selected content as rich HTML and plain text, or explicitly copy the whole note. Vault images become embedded clipboard images. Resource URLs are never saved or exported. HTML destination compatibility is a separate opt-in.
  • Preserve unsupported source in Source mode. Unsupported pasted markup requires an explicit choice to preserve its original in a separate file before safe insertion.
  • Sanitize with DOMPurify, allowlist inline CSS and render inside a script-disabled frame. Inactive-document parsing prevents detached image requests. Opening notes does not contact image servers.
  • Add preservation, security, clipboard and persistence tests plus real Chromium editor/view integration tests. Existing Markdown workflows remain unchanged.

Compatibility and limits

Requires Obsidian Desktop 1.8.0 or later. HTML handler conflicts keep the other plugin's handler; Open in HTML notes remains available. Reload after changing enablement or automatic handling.

Table spans are retained; visual row/column restructuring of merged tables requires Source. Stylesheets, unsupported structures/CSS and active embeds stay in Source. SVG needs raster export. Mode switches reset that mode's undo history. Native HTML backlinks and graph indexing are not added.

Movidesk and other destination editors control paste filtering and image retention. Authenticated Movidesk acceptance remains a documented manual step; pixel-perfect compatibility is not claimed. See the HTML notes guide for behavior, limits, architecture and the acceptance checklist.

Install

Download main.js, manifest.json and styles.css into <your-vault>/.obsidian/plugins/visual-kit/, then restart Obsidian. All three assets are built and attested by GitHub Actions. Bundled dependency licenses are included in main.js.

README file from

Github

Visual Kit

Turn screenshots and rich text into clear, shareable notes.

Capture evidence, annotate screenshots, edit HTML notes, and copy formatted responses between Obsidian and rich-text editors. Everything is processed locally in your vault.

Created by pedrof.

Download · Support on Ko-fi

Visual Kit by pedrof: batch paste, rich paste, annotations, HTML notes, image sizing, deduplication, and rich copy

Features

  • Batch paste — insert several images at once, in their original order.
  • Rich paste — keep text and images in order when pasting from email, web pages, and other rich-text editors. Public images can be imported into the vault; unavailable images show a warning and placeholder.
  • Annotate — add arrows, shapes, text, numbered markers, highlights, and redactions.
  • Normalize — give every image in a note or selection a consistent width.
  • Deduplicate — reuse identical images instead of saving extra copies.
  • Rich copy — copy formatted text and images together into a rich-text editor.
  • HTML notes — create real HTML files with visual, source and preview modes; paste, edit and copy formatted responses with fonts, colors, tables and images.

Save annotated images as new PNGs, keep editable annotations, and undo or redo changes as you work. All image processing happens locally.

Installation

Requires Obsidian Desktop 1.8.0 or later.

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Place them in <your-vault>/.obsidian/plugins/visual-kit/.
  3. Restart Obsidian and enable Visual Kit under Settings → Community plugins.

Quick start

Screenshots and Markdown

  1. Paste screenshots into a note.
  2. Right-click an image and choose Annotate.
  3. Add your annotations and choose Save as new.
  4. Run Visual Kit: Normalize image sizes to set a consistent width.
  5. Select your documentation and run Visual Kit: Copy with images. Enable Destination compatibility mode for inline text and PNG images resized to their copied dimensions.

Copy with images uses your Markdown selection, or the whole note if nothing is selected. Formatting and image support depend on the destination editor.

HTML notes and rich-text responses

  1. Click Add HTML note beside New note in the file explorer, run Visual Kit: Create HTML note, or right-click a folder and choose Create HTML note. Type a name and press Enter; the .html extension is added automatically.
  2. Paste a formatted response into Visual mode. Use the toolbar for text styling, lists, tables, and images.
  3. Switch to Source to inspect HTML, or Preview for a read-only view. Changes autosave locally.
  4. Select content and run Copy as rich HTML, or choose Copy whole note to export everything.
  5. Paste into your destination editor and verify the saved result.

HTML notes are real .html files. Unsupported markup stays in Source mode to protect the original. See the HTML notes guide for image handling, recovery, compatibility, and known limits.

Copying to Movidesk

For HTML formatting that survives save/reopen, run Visual Kit: Create HTML note. Paste into Visual, edit with the toolbar, then select content for Copy as rich HTML or use Copy whole note. HTML notes autosave and retain unsupported documents in Source mode to protect their original content. See the HTML notes guide and manual acceptance checklist.

The options below describe Markdown Copy with images. HTML note copy preserves its own typography by default and has a separate destination compatibility opt-in.

Paste at the desired position inside your macro. Compatibility mode avoids outer blocks that can reset the destination font. If Movidesk still resets typography, set Destination font, Destination font size (px), and Destination text color to match your macro; leave them empty for inheritance. Disable Preserve formatting if you also want to remove emphasis.

Use Normalize image sizes on copy for a consistent width, or Preserve resize to honor embed dimensions. Compatibility mode bakes that size into PNG pixels without modifying source files. GIF animation is flattened. Export SVG files as PNG before rich copying.

Images are embedded in clipboard HTML, not uploaded to Movidesk. If images disappear after saving or reopening a ticket, use Movidesk's image upload tool and verify the saved ticket. Copying cannot override destination security filters. Invalid images leave the clipboard unchanged with a named error. Large batches may need to be split.

Editor shortcuts

Shortcut Action
V / A / R / E Select / arrow / rectangle / ellipse
T / D / N / H Text / draw / number / highlight
Ctrl+Z / Ctrl+Shift+Z Undo / redo
Ctrl+S Save
Ctrl+Shift+C Copy annotated image
Ctrl + scroll / Space + drag Zoom / pan

Use Cmd instead of Ctrl on macOS. Customize global shortcuts in Settings → Hotkeys.

When sharing redacted evidence, send only the exported PNG. The original image and editable annotation file may still contain the covered information.

Development

npm ci
npm run lint
npm run check
npm test
npm run build

The installable plugin is generated in dist/visual-kit.

Regenerate the README overview with npm run assets:readme. Its editable SVG and exported PNG are stored in docs/community-assets/.

Support

Enjoy using Visual Kit? Buy me a coffee on Ko-fi.

MIT License