Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Media Viewer

devon22devon2210k downloads

Transform notes with beautiful interactive media galleries and seamless fullscreen viewer.

Add to Obsidian
Media Viewer screenshot
  • Overview
  • Scorecard
  • Updates61

English | 日本語 | 中文

Introduction

Media Viewer is a plugin designed for Obsidian, aiming to provide an intuitive media browser that allows users to easily view media files (such as images and videos) within their notes.

demo1 demo2

Features

  • Media Browser: View all media files in a note in full-screen mode.
  • Click to Open Media: Open the media browser by clicking on an image.
  • Create Gallery Block: Create a media gallery block to display multiple media files in a grid format within a note.

Installation

  1. Download the latest version of this plugin.
  2. Place the plugin folder in Obsidian's plugin directory.
  3. Enable this plugin in Obsidian.

Usage

  • Open a note and use the command palette (Ctrl + P) to select "Open Media Viewer" to view media files within the note.
  • Click on media thumbnails to view full-screen previews.
  • Use keyboard arrow keys to switch between media files.

Gallery Block Usage

demo3

You can create a Gallery block in a note using the following format:

```gallery
![[image1.jpg]]
![[image2.jpg]]
![[image3.jpg]]
![[video.mp4]]
[[note]]
```

Create Gallery Block Using Commands

demo4 demo5 demo6

After creation, you can directly drag and drop images into the block to add them.

Gallery Additional Parameters

Attribute Description
title: text or [[link]] Used to set the title of the Gallery
size: small or medium or large Thumbnail size of the Gallery
addButton: true or false Whether to display the add image button
pagination: number Display pagination when the number of images in the Gallery exceeds this number
alt: text or [[link]] Placed on the line above the image link, can serve as a description for the image
img: image.jpg or ![[image.jpg]] Placed on the line above the note link, can be displayed as a thumbnail
filter: text Used to filter Gallery content
```gallery
size: small
addButton: true
title: gallery

alt: image1
![[image1.jpg]]

alt: image2
![[image2.jpg]]

alt: image3
![[image3.jpg]]

![[video.mp4]]

img: image4.jpg
[[note]]
```

Settings

In the plugin's settings page, you can customize the following options:

  • Allow deletion of media files
  • Auto-open the first image
  • Open media browser when clicking on an image
  • Adjust the Gallery Grid layout width

License

This plugin follows the MIT License.

HealthExcellent
ReviewSatisfactory
About
Easily browse, zoom, and manage images, videos, and audio files directly within your notes. This plugin provides a fullscreen media viewer with keyboard navigation and click-to-open previews, alongside customizable, responsive grid layouts supporting drag-and-drop, thumbnails, and pagination.
ImagesVideoAttachments
Details
Current version
2.2.1
Last updated
Last month
Created
2 years ago
Updates
61 releases
Downloads
10k
Compatible with
Obsidian 1.8.7+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
devon22devon22
github.com/Devon22
GitHubdevon22
  1. Community
  2. Plugins
  3. Images
  4. Media Viewer

Related plugins

Ink

Handwriting and drawing directly between paragraphs using a digital pen, stylus, or Apple pencil.

Imagine

A comprehensive image management plugin for managing, inserting, resizing, viewing, and batch processing images.

Pixel Perfect Image

Pixel perfect 100% image resizing, copy to clipboard, show image in Finder/Explorer, and much more.

Local Images Plus

A reincarnation of Local Images to download images in Markdown notes to local storage.

Image Context Menus

Image context menus (mostly on right click): Copy to clipboard, Open in default app, Show in system explorer, Reveal file in navigation, Open in new tab.

Pixel Banner

Enhance your notes with customizable banner images.

Paste image rename

Rename image after pasting, support name pattern and auto renaming.

Image auto upload

Upload images from your clipboard by PicGo.

Imgur

Upload images from your clipboard to imgur.com and embeds uploaded image to your note.

Local images

Find all links to external images in your notes, download and save images locally, and adjust the image links in your notes to point to the saved image files.