Comment on page
Markdown Viewer
Open Markdown files in your terminal and run commands.
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:
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 from the right-click context menu on the link.
Opening a Markdown file in Warp using the link tooltip
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
From Finder, you can open a Markdown file in Warp from the “Open With” menu that appears when right-clicking on the file.
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 in order 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
orCMD-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.If the command contains any arguments using the curly brace
{{param}}
syntax, they will be treated as workflow arguments. Learn more about workflows.
Navigating between and running commands in a Markdown file
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
.Last modified 22d ago