janispritzkau

obsidian-model-viewer: View 3D Models in Obsidian

An Obsidian plugin for opening and embedding interactive glTF and GLB models in vaults. It suits people who want to preview 3D assets alongside their notes, with controls provided by Google’s model-viewer component.

View on GitHub Compare
Stars
21
Forks
2
Stars, last 30 days
+0

Our take

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

21

Forks

2

Change since Nov 17, 2026: 0 stars·0 forks

Overview

obsidian-model-viewer adds support for interactive 3D models to Obsidian vaults. It lets users browse model files, open them in tabs, preview them on hover, and embed them directly in Markdown notes.

It is a fit for Obsidian users who keep 3D assets with their research, documentation, or project notes and want to inspect them without leaving the vault. Models use Google’s <model-viewer> component, which supports glTF and GLB formats.

Key Features

  • Recognizes .glb and .gltf files in an Obsidian vault for browsing and tab-based viewing.
  • Supports hover previews when Obsidian’s page preview plugin is enabled.
  • Embeds models in notes using Obsidian’s native ![[...]] syntax.
  • Allows embed sizing through height, aspect ratio, and width options.
  • Supports <model-viewer> attributes for adjusting model behavior and presentation.
  • Supports popular glTF extensions, including Draco compression and KTX2 textures.

Use Cases

  • 3D artists and asset reviewers: Keep model files beside project notes and inspect them in Obsidian.
  • Technical writers: Embed interactive models in documentation notes to provide visual context.
  • Researchers and students: Organize 3D assets with related references and view them while navigating a vault.
  • Teams maintaining model catalogs: Place multiple models side by side in a note for quick comparison.

Getting Started

Install the plugin in Obsidian, then embed a model stored in your vault with syntax such as ![[model.glb]]. See the repository README for embed options and supported attributes.

Considerations

  • The viewer supports glTF and GLB models, not arbitrary 3D file formats.
  • Hover previews depend on Obsidian’s page preview plugin being enabled.
  • This is an Obsidian plugin, so it is intended for use within an Obsidian vault rather than as a standalone model viewer.

Found this useful?

Share it with someone who would like obsidian-model-viewer.