#Obsidian Documentation Single Markdown

Name: Obsidian Documentation Dataset
Creator: Obsidian

Obsidian is a developer tool with comprehensive developer documentation. The full documentation spans 200 pages and 1.6 MB, last crawled 3 weeks ago. This page reflects the latest available version.

Obsidian / latest

200 pages·1.48 MB·updated Mar 13, 2026

### preview

[](https://docs.obsidian.md/Home)[Developer Documentation](https://docs.obsidian.md/Home)

Plugins

Getting started

Guides

[Build a Bases view](https://docs.obsidian.md/plugins/guides/bases-view)

[Defer views](https://docs.obsidian.md/plugins/guides/defer-views)

[Optimize plugin load time](https://docs.obsidian.md/plugins/guides/load-time)

[Store secrets](https://docs.obsidian.md/plugins/guides/secret-storage)

[Support pop-out windows](https://docs.obsidian.md/plugins/guides/pop-out-windows)

User interface

Editor

Releasing

[Events](https://docs.obsidian.md/Plugins/Events)

[Vault](https://docs.obsidian.md/Plugins/Vault)

Themes

Reference

[Developer policies](https://docs.obsidian.md/Developer+policies)

[Home](https://docs.obsidian.md/Home)

[](https://docs.obsidian.md/Home)[Developer Documentation](https://docs.obsidian.md/Home)

Support pop-out windows

=======================

    aliases:

      - Plugins/Guides/Supporting Pop-Out Windows

    permalink: /plugins/guides/pop-out-windows

With the release of [Obsidian v0.15.0](https://obsidian.md/changelog/2022-06-14-desktop-v0.15.0/), the pop-out windows feature was added to the desktop version of Obsidian.

For most plugins, this feature should work out-of-the-box. However, some things work differently when your plugin renders things in pop-out windows.

Most importantly, pop-out windows come with a complete different set of globals. Each pop-out window introduces its own `Window` object, `Document` object, and fresh copies of all global constructors (like `HTMLElement` and `MouseEvent`).

This means that some of the things you previously had assumed to be global and use only _a single_ definition, will now only work in the main window. Here are some examples:

    let myElement: HTMLElement = ...;

    // This will always append to the main window

    document.body.appendChild(myElement);

    // This will actually be false if element is in a pop-out window

    if (myElement instanceof HTMLElement) {

    }

    element.on('click', '.my-css-class', (event) => {

        // This will be false if the event is triggered in a pop-out window

        if (event instanceof MouseEvent) {

        }

    }

The Obsidian API includes various helper function and accessors to better support pop-out windows:

*   A global `activeWindow` and `activeDocument` variable, which always points to the current focused window and its document.

*   An `element.win` and `element.doc` getter, which respectively point to the `Window` and `Document` objects that the element belongs to.

*   A function for performing cross-window compatible `instanceof` checks. Use `element.instanceOf(HTMLElement)` and `event.instanceOf(MouseEvent)`, instead of `element instanceof HTMLElement` and `event instanceof MouseEvent`.

*   `HTMLElement.onWindowMigrated(callback)` which hooks a callback on the element for when it is inserted into a different window than it originally was in. This can be used for complex renderers

##About Obsidian

Obsidian is a private, local Markdown note-taking app for building a personal knowledge base. It stores notes on your device and lets you link ideas, visualize connections with a graph, and extend functionality via plugins and themes. The official documentation covers 200 pages of technical reference. This entry reflects the current stable release.

category:[Second Brain & Knowledge Management]

source: https://docs.obsidian.md