Warp documentation
  • Getting Started
    • Quickstart Guide
    • What is Warp?
    • Supported Shells
    • Migrate to Warp
    • Keyboard Shortcuts
    • Changelog
  • Agents
    • Warp AI
    • Using Agents
      • Agent Conversations
      • Agent Context
      • Model Choice
    • Autonomy
      • Agent Permissions
      • Run to completion
    • Code
      • Codebase Context
      • Reviewing Agent Code
    • Active AI
    • Generate
    • Voice
    • AI FAQs
  • Terminal
    • Appearance
      • Themes
      • Custom Themes
      • Prompt
      • Input Position
      • Text, Fonts, & Cursor
      • Size, Opacity, & Blurring
      • Pane Dimming & Focus
      • Blocks Behavior
      • Tabs Behavior
      • App Icons
    • Blocks
      • Block Basics
      • Block Actions
      • Block Sharing
      • Block Find
      • Block Filtering
      • Background Blocks
      • Sticky Command Header
    • Modern Text Editing
      • Alias Expansion
      • Command Inspector
      • Syntax & Error Highlighting
      • Vim Keybindings
    • Command Entry
      • Command Corrections
      • Command Search
      • Command History
      • Synchronized Inputs
      • YAML Workflows
    • Command Completions
      • Completions
      • Autosuggestions
    • Command Palette
    • Session Management
      • Launch Configurations
      • Session Navigation
      • Session Restoration
    • Window Management
      • Global Hotkey
      • Tabs
      • Split Panes
    • Warpify
      • Subshells
      • SSH
      • SSH Legacy
    • More Features
      • Accessibility
      • Files, Links, & Scripts
      • Markdown Viewer
      • Working Directory
      • Smart-Select
      • Full-screen Apps
      • Notifications & Audible Bell
      • Settings Sync (Beta)
      • Quit Warning
      • URI Scheme
      • Linux
    • Comparisons
      • Performance
      • Terminal features
    • Integrations
  • Knowledge & Collaboration
    • Warp Drive
      • Notebooks
      • Workflows
      • Prompts
      • Environment Variables
      • Warp Drive on the Web
      • Warp Drive as Agent Mode Context
    • Model Context Protocol
    • Rules
    • Teams
    • Session Sharing
  • Privacy
    • Privacy
    • Secret Redaction
    • Network Log
  • Community
    • Refer a Friend & Earn Rewards
    • Warp Preview & Alpha Program
  • Support & Billing
    • Sending Feedback & Logs
    • Plans & Pricing
      • Usage Overages
    • Updating Warp
    • Using Warp Offline
    • Logging out & Uninstalling
    • Known Issues
    • Troubleshooting Login Issues
    • Open Source Licenses
Powered by GitBook
On this page
  • Opening a file link within a block
  • Markdown-viewing commands
  • Opening a Markdown file from Finder
  • Shell commands in Markdown files

Was this helpful?

  1. Terminal
  2. More Features

Markdown Viewer

Open Markdown files in your terminal and run commands.

PreviousFiles, Links, & ScriptsNextWorking Directory

Last updated 23 days ago

Was this helpful?

Warp can display Markdown files directly in a split pane, in addition to opening them in an external editor. Any local file with the .md or .markdown extension is treated as a Markdown file. Remote files are currently not supported.

There are three ways to view a Markdown file in Warp, you can also configure Warp to open markdown files with the default external editor or Warp's built-in markdown viewer in Settings > Features > General > Open Markdown files in Warp's Markdown viewer by default.

Opening a file link within a block

For any link to a Markdown file within a block, you can open the file in Warp by CMD-clicking on the link, from the link tooltip, or the right-click context menu on the link.

For any link to a Markdown file within a block, you can open the file in Warp by CTRL-clicking on the link, from the link tooltip, or the right-click context menu on the link.

For any link to a Markdown file within a block, you can open the file in Warp by CTRL-clicking on the link, from the link tooltip, or the right-click context menu on the link.

Markdown-viewing commands

If you run a Markdown-viewing command like cat myfile.md, Warp will show a banner with a button to open the Markdown file.

The following commands are considered Markdown viewers:

  • cat

  • glow

  • less

Opening a Markdown file from Finder

From Finder, you can open a Markdown file in Warp from the “Open With” menu that appears when right-clicking on the file.

Shell commands in Markdown files

Warp can run shell commands from Markdown code blocks in your active terminal session. Click the run icon >_ to insert a command into the terminal input.

The shell command must be in a code block with three backticks ``` and not inline code for Warp to treat the code like a runnable command.

Markdown shell blocks also support keyboard navigation. There are two ways to enter the keyboard navigation mode:

  • Clicking on a shell block.

  • Pressing CMD-UP or CMD-DOWN.

Once a shell block is selected, press CMD-ENTER to insert it into the terminal input. You can also use UP, DOWN, CMD-UP, and CMD-DOWN to navigate between shell blocks. While the Markdown file is focused, press CMD-L to switch focus back to the terminal without inserting a command.

  • Clicking on a shell block.

  • Pressing CTRL-UP or CTRL-DOWN.

Once a shell block is selected, press CTRL-ENTER to insert it into the terminal input. You can also use UP, DOWN, CTRL-UP, and CTRL-DOWN to navigate between shell blocks. While the Markdown file is focused, press CTRL-SHIFT-L to switch focus back to the terminal without inserting a command.

  • Clicking on a shell block.

  • Pressing CTRL-UP or CTRL-DOWN.

Once a shell block is selected, press CTRL-ENTER to insert it into the terminal input. You can also use UP, DOWN, CTRL-UP, and CTRL-DOWN to navigate between shell blocks. While the Markdown file is focused, press CTRL-SHIFT-L to switch focus back to the terminal without inserting a command.

If the command contains any arguments using the curly brace {{param}} syntax, they will be treated as Workflow arguments. Learn more about Workflows.

In addition, all shell and code blocks have a copy button to quickly copy the block’s text to the clipboard.

Code blocks without a set language, or one of the following languages, are treated as shell commands: sh, shell, bash, fish, zsh, warp-runnable-command.

Opening a Markdown file in Warp using the link tooltip
Navigating between and running commands in a Markdown file
Clicking a Markdown file link in the output of ls to open it in Warp
Demo of running two commands from a Markdown file in Warp