Skip to content

contrib: Style Inspector Chrome extension + themed offline viewer - #57

Open
neo37 wants to merge 1 commit into
mapitman:mainfrom
neo37:style-inspector-and-themes
Open

contrib: Style Inspector Chrome extension + themed offline viewer#57
neo37 wants to merge 1 commit into
mapitman:mainfrom
neo37:style-inspector-and-themes

Conversation

@neo37

@neo37 neo37 commented Aug 11, 2026

Copy link
Copy Markdown

What this adds

A contrib/ directory with companion tooling that lets mdview users render markdown in the visual style of any website:

  • contrib/chrome-extension/ — Style Inspector, a Manifest V3 Chrome extension that extracts a site's design tokens (logo, background/text colors, fonts, paddings) from computed styles. Tokens can be exported/imported as JSON files, and one click derives a ready-to-use viewer theme from the page palette (most frequent background/text colors, two most saturated colors as accents, font stack, logo URL).
  • contrib/mdview-themed — a self-contained, offline bash viewer (marked + mermaid) that renders .md files using an installable theme: --install-theme theme.json (downloads the logo for offline use), --reset-theme, --show-theme. Mermaid diagrams are re-colored to match the theme.
  • Installer script, example theme file, and a contrib/README.md documenting the workflow and theme format.

Why

Teams often want internal docs rendered in their corporate style rather than the default GitHub look. This flow — inspect a site → export a theme → install it — makes that a one-minute setup and the theme files are easy to share between machines and teammates.

Everything is additive and self-contained under contrib/; no changes to the Go code or existing behavior. Happy to rework the layout or drop parts of it if you'd prefer a narrower scope.

🤖 Generated with Claude Code

- contrib/chrome-extension: Style Inspector (MV3) — extracts a site's logo,
  colors, fonts and paddings; export/import styles as JSON; one click derives
  an mdview theme from the page palette
- contrib/mdview-themed: offline bash markdown viewer (marked + mermaid) that
  renders .md files with an installable corporate theme: colors, font stack,
  logo in the header, mermaid re-colored to match
- contrib/install-mdview-themed.sh: installer (fetches marked/mermaid)
- contrib/mdview-theme.example.json + contrib/README.md: theme format and workflow
- README.md: note about the fork additions
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant