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

devon22devon227k downloads

View and manage media files within your notes.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates49

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.

93%
HealthExcellent
ReviewPassed
About
Browse media files in a note in a full-screen viewer with keyboard navigation and click-to-open previews. Create responsive gallery blocks to display images and videos in customizable grids, with drag-and-drop, thumbnails, and optional pagination.
ImagesVideoAttachments
Details
Current version
2.1.3
Last updated
Last week
Created
Last year
Updates
49 releases
Downloads
7k
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

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.

Ink

Hand write or draw directly between paragraphs using a digital pen, stylus, or Apple pencil.

Local Images Plus

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

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.

Unofficial Supernote by Ratta Integration

View Supernote notes, generate markdown from note and capture screen mirror.

Image Manager

Insert, rename, and sort images within your notes.

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.