> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Markdown Viewer

Open Markdown files in your terminal and run commands.

Warp can be used for both editing and viewing rendered Markdown files in a [split pane](/terminal/windows/split-panes/). Any local file with the `.md` or `.markdown` extension is treated as a Markdown file. Remote files are currently not supported. Turning on **Settings** > **Features** > **General** > **Open Markdown files in Warp’s Markdown viewer by default** will make the Markdown viewer default, otherwise Markdown files will open in Warp’s editor.

### Opening a file link within a block

-   [macOS](#tab-panel-797)
-   [Windows](#tab-panel-798)
-   [Linux](#tab-panel-799)

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.

![Clicking a Markdown file link in the output of ls to open it in Warp](/assets/terminal/open-markdown-viewer.gif)

Opening a Markdown file via link tooltip.

### 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.

### Toggling between editor and viewer

You can toggle between the Markdown editor and viewer via the pane overflow menu.

![Clicking a Markdown file link in the output of ls to open it in Warp](/assets/terminal/markdown-raw-rendered-toggle.gif)

Toggling between editor and viewer.

## 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.

Note

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:

-   [macOS](#tab-panel-800)
-   [Windows](#tab-panel-801)
-   [Linux](#tab-panel-802)

-   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](/knowledge-and-collaboration/warp-drive/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`.