Our take
- 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.
Stars
21Forks
2Change 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
.glband.gltffiles 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.