# Open in New Tab

![Status Page](https://img.shields.io/badge/status-all%20systems%20probably%20fine-fff?style=flat&logo=statuspage&logoColor=FFFFFF&label=status&labelColor=5B595C&color=AB9DF2) ![All Your Base](https://img.shields.io/badge/all%20your%20base-are%20belong%20to%20us-fff?style=flat&logo=retroarch&label=all%20your%20base&labelColor=5B595C&color=5C7CFA) ![GIF Quality](https://img.shields.io/badge/gif%20quality-potato%20certified-fff?style=flat&logo=giphy&logoColor=FFFFFF&label=gif%20quality&labelColor=5B595C&color=FFD866) ![Frog Mode](https://img.shields.io/badge/frog%20mode-ribbit-fff?style=flat&logo=duolingo&logoColor=FFFFFF&label=frog%20mode&labelColor=5B595C&color=5C7CFA) ![VHS Tracking](https://img.shields.io/badge/vhs%20tracking-adjusting-fff?style=flat&logo=youtube&logoColor=FFFFFF&label=VHS%20tracking&labelColor=5B595C&color=78DCE8) ![Debugging](https://img.shields.io/badge/debugging-print%20statements-fff?style=flat&logo=gnometerminal&logoColor=FFFFFF&label=debugging&labelColor=5B595C&color=78DCE8) ![Jira](https://img.shields.io/badge/jira-947%20open%20tickets-fff?style=flat&logo=jira&logoColor=FFFFFF&label=jira&labelColor=5B595C&color=5C7CFA) ![Days Since Incident](https://img.shields.io/badge/days%20since%20incident-0-fff?style=flat&logo=fireship&logoColor=FFFFFF&label=days%20since%20incident&labelColor=5B595C&color=A9DC76) ![Typing](https://img.shields.io/badge/typing-three%20dots%20forever-fff?style=flat&logo=whatsapp&logoColor=FFFFFF&label=typing&labelColor=5B595C&color=5C7CFA)

<p align="center">
  <img src="assets/header.svg" width="600" />
</p

An Obsidian plugin that forces files to open in new tabs instead of replacing the current tab.

## Features

- **Universal coverage**: Works with Quick Switcher, command palette, bookmarks, search results, backlinks, graph view, sidebar clicks, and markdown links
- **Focus existing tab**: If a file is already open in another tab, focuses that tab instead of opening a duplicate
- **Same-file navigation**: Clicking heading/block links within the same file stays in the current tab
- **Split preview mode**: Automatic side-by-side split with an edit pane and a reading view pane that stay in sync
- **Non-invasive**: Only changes the default "reuse current tab" behavior; all other Obsidian navigation (splits, popout windows) passes through unchanged
- **Toggleable**: Enable/disable via settings, command palette, or Note Toolbar helpers button

## How It Works

Monkey-patches `Workspace.getLeaf()` to intercept calls that would reuse the current tab (`getLeaf()` or `getLeaf(false)`) and forces them to open a new tab instead (`getLeaf('tab')`). Calls that already request a new tab, split, or window pass through unchanged.

Also patches `openLinkText()` to handle same-file heading navigation (stays in current tab) and already-open file detection (focuses existing tab).

## Split Preview Mode

When enabled, automatically creates a split view:

- **Left/top pane**: Edit mode (source mode or live preview, configurable)
- **Right/bottom pane**: Reading view (always)
- **Synced navigation**: Switching files in either pane updates the other to show the same file
- **Split direction**: Configurable as right (vertical) or down (horizontal), defaults to right

Toggle via:
- Settings > Split preview mode > Enable split preview
- Command palette: "Open in New Tab: Toggle split preview mode"
- Note Toolbar helpers button (if obsidian-note-toolbar is installed)

## Installation

### Obsidian Community Plugin

This plugin is available in the official Obsidian community plugin directory. Install it from **Settings > Community plugins > Browse** and search for "Open in New Tab" or "Open in New Tab by saltyfireball".

Community plugin page: <https://community.obsidian.md/plugins/sfb-open-in-new-tab>

## More Plugins by saltyfireball

Browse all of my published Obsidian plugins on my profile: <https://community.obsidian.md/users/saltyfireball>

## Settings

- **Enable open in new tab**: Toggle the new-tab behavior on/off
- **Focus existing tab**: Focus an already-open tab instead of opening a duplicate
- **Enable split preview**: Auto-create a synced edit + reading view split
- **Split direction**: Right (vertical) or down (horizontal)
- **Edit pane mode**: Source mode or live preview for the edit pane

## Cross-Plugin API

Exposes `window.openInNewTabAPI` for other plugins:

- `isSplitPreviewActive()`: Returns whether split preview mode is on
- `toggleSplitPreview()`: Toggles split preview mode on/off

## License

MIT