Commands allow you to execute applications from Notepad++, for example to open your current file in a browser or compile it with some external compiler. You can pass the program command line parameters based on the current status of your document.


To run a new command:

Sselect Run->Run.... A dialog will pop up asking for the path to the program and possible any command line parameters. You can use the browse button to search for your program. The drop down list provides recently run programs. The command line arguments can also be based on the status of the current document, and are always enclosed in $(...), where … can be:

the fully qualified path to the current document.
The directory the current document resides in.
The filename of the document, without the directory.
The filename without the extension.
The extension of the current document.
The directory that contains the notepad++.exe executable that is currently running.
The currently selected text in the document.
The current line number that is selected in the document (0 based index, the first line is 0).
The current column the cursor resides in (0 based index, the first position on the line is 0).

For example,

"$(NPP_DIRECTORY)\notepad++.exe" -multiInst "$(FULL_CURRENT_PATH)"

would start a new instance of Notepad++ opening the current file. Remember to put quotes around paths if it can contain spaces. For the Notepad++ command line options, see Command Line.


To run an existing command:

Select it from the Run menu below the Run... option. If no commands are saved, the list will be empty.



To save the command:

Sselect Run->Run..., enter the command and press Save.... A dialog will pop up asking for a name of the command and the default key combination. Once saved, the command will be available from the Run menu.


To edit or delete an existing command:

The Shortcut Mapper (see Shortcut Mapper) displays all available commands in a uniform way, so you can modify or delete any shortcut you defined, including Run commands. This procedure is also available from Run -> Modify shortcut / Delete command. As the name suggests, this does not extend to editing the command text proper - you need to edit shortcuts.xml to do that.