# Obsidian Model Viewer: Embed 3D Models in Your Obsidian Vault

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/janispritzkau-obsidian-model-viewer
Generated for open source discovery and AI-assisted research.

Obsidian Model Viewer is a powerful plugin that integrates interactive 3D models directly into your Obsidian vault. Utilizing Google's <model-viewer> component, it enables seamless viewing and embedding of glTF/GLB files within your notes. This enhances your knowledge base by allowing you to visualize complex 3D data alongside your text.

GitHub: https://github.com/janispritzkau/obsidian-model-viewer
OSRepos URL: https://osrepos.com/repo/janispritzkau-obsidian-model-viewer

## Summary

Obsidian Model Viewer is a powerful plugin that integrates interactive 3D models directly into your Obsidian vault. Utilizing Google's <model-viewer> component, it enables seamless viewing and embedding of glTF/GLB files within your notes. This enhances your knowledge base by allowing you to visualize complex 3D data alongside your text.

## Topics

- obsidian-md
- obsidian-plugin
- typescript
- 3d-models
- visualization
- knowledge-management
- gltf
- glb

## Repository Information

Last analyzed by OSRepos: Tue Jan 20 2026 00:00:31 GMT+0000 (Western European Standard Time)
Detail views: 4
GitHub clicks: 1

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction
The Obsidian Model Viewer plugin brings the power of interactive 3D models directly into your Obsidian notes. Developed by janispritzkau, this plugin leverages Google’s robust `<model-viewer>` component to display and embed 3D models in glTF/GLB format. It transforms your Obsidian vault into a richer environment for visualizing complex data, designs, or educational content.

## Installation
To install the Obsidian Model Viewer plugin, follow these standard steps for community plugins within Obsidian:
1.  Open Obsidian and navigate to `Settings`.
2.  Go to `Community plugins` and ensure `Restricted mode` is turned off.
3.  Click `Browse` and search for 'Obsidian Model Viewer'.
4.  Select the plugin, click `Install`, and then `Enable` it.

## Examples
The plugin integrates seamlessly with Obsidian's native embed syntax. Here are some examples of how you can embed 3D models:

**Basic Embed:**
markdown
![[DamagedHelmet.glb]]


**Specify Height:**
markdown
![[Duck.glb#height=400]]


**Specify Aspect Ratio:**
markdown
![[Sponza.gltf#aspect=16:9]]


**Specify Aspect Ratio and Width:**
markdown
![[StainedGlassLamp.gltf#aspect=1|320]]


**Multiple Models Side-by-Side:**
markdown
![[A.glb|160]] ![[B.glb|160]] ![[C.glb|160]]


**Using `<model-viewer>` Attributes:**
You can also pass any attributes supported by the underlying `<model-viewer>` component.
markdown
![[Fox.glb#autoplay&camera-controls=false&camera-orbit=30deg+80deg+80%]]

For a full list of attributes, refer to the official `<model-viewer>` documentation.

## Why Use Obsidian Model Viewer?
The Obsidian Model Viewer offers several compelling reasons to integrate it into your workflow:
*   **Rich Visualization:** Directly view and interact with 3D models, making your notes more dynamic and informative.
*   **Extensive Format Support:** It supports `.glb` and `.gltf` files, including popular glTF extensions like Draco compression and PBR materials, ensuring high-quality rendering.
*   **Seamless Obsidian Integration:** Enjoy native Obsidian features such as file viewing, hover previews, and markdown embed syntax, all tailored for 3D models.
*   **Customization:** Leverage the full power of `<model-viewer>` attributes to customize model behavior, camera controls, and appearance directly from your notes.
*   **Future-Proof Standard:** Utilizes glTF, known as the 'JPEG of 3D', which is compact, compressible, and optimized for rapid GPU loading.

## Links
Find more information and contribute to the project via the links below:
*   **GitHub Repository:** [https://github.com/janispritzkau/obsidian-model-viewer](https://github.com/janispritzkau/obsidian-model-viewer){target=_blank}
*   **<model-viewer> Documentation:** [https://modelviewer.dev/docs/index.html](https://modelviewer.dev/docs/index.html){target=_blank}