Home

Awesome

Markdown Syntax Highlighting for Notepad++

This repo "markdown-plus-plus" is a project to support Markdown syntax highlighting in Notepad++. It is done via various User Defined Language (UDL) XML files. All UDLs are carefully designed by human, rather than generated by machine.

You can simply consume the UDL XML file that matches your favorite theme, or config your own using the build system.

Thanks for encouragements and comments. This repo is not only for myself anymore. It's for everyone.

Love Notepad++? Need to write docs in Markdown? This repo is made for you.

Screenshots

YourTaste!
Markdown in Default Theme of Notepad++Markdown in Zenburn Theme of Notepad++
DefaultZenburn
Markdown in Bespin Theme of Notepad++Markdown in Blackboard Theme of Notepad++
BespinBlackboard
Markdown in Deep Black Theme of Notepad++Markdown in Obsidian Theme of Notepad++
Deep BlackObsidian
Markdown in Solarized Theme of Notepad++Markdown in Solarized-light Theme in Notepad++
SolarizedSolarized-light
Markdown in Twilight Theme of Notepad++Markdown in Material Theme in Notepad++
TwilightMaterial

Supports file extensions: .markdown and .md<br> Tested: Notepad++ v8.4.4 64-bit on Windows 10

Usage

Node.js

If you had installed Node.js in your system, you can use npx command to get UDL file(s):

:: Check whether you have Node.js installed
node -v

:: Go to UDL folder of Notepad++. Usually...
cd %AppData%\Notepad++\userDefineLangs

:: Example: Download Solarized-light UDL file
npx markdown-plus-plus solarized-light

:: Example: Download Solarized UDL file for Dark Mode
npx markdown-plus-plus solarized --dark

:: Read help for details
npx markdown-plus-plus --help

You can choose to install this package in your system:

:: Enable `mpp` command instead of `npx markdown-plus-plus`...
npm install --global markdown-plus-plus

:: List all themes
mpp --list

:: Example: Download Solarized-light UDL file
mpp solarized-light

:: Example: Download Solarized UDL file for Dark Mode
mpp solarized --dark

:: Update this package
npm update markdown-plus-plus

Download Manually

  1. Download the source code in latest release page. It should be a zip file.
  2. Open the zip file and go to <udl\> folder.
  3. Copy a XML file of your favorite theme, and paste in <userDefineLangs\> folder of Notepad++. The directory is usually <%AppData%\Notepad++\userDefineLangs\>.
  4. Restart Notepad++.
  5. Open and test with a Markdown file e.g. test/at-a-glance.md.

Enjoy!!

Dark Mode

Notepad++ features Dark Mode with great UDL enhancements since v8.1.3. In short, you may want 2 files:

:: Make sure you are running mpp v3.4+
mpp --version

:: Go to UDL folder of Notepad++. Usually...
cd %AppData%\Notepad++\userDefineLangs

:: Download Solarized UDL file
mpp solarized

:: Download Solarized UDL file for Dark Mode,
:: even though you use the same theme
mpp solarized --dark

NPP will pick up the correct file for dark mode. Here're some conventions in this package:

NormalDark Mode
Commandmpp <theme-name>mpp <theme-name> --dark
Filename<markdown.theme-name.udl.xml><markdown.theme-name.dark.udl.xml>
UDL nameTheme Name (markdown)Theme Name [markdown]

Limitations

Need your input to solve the following problems:

If Notepad++ doesn't redraw your current markdown file(s), please re-open the NPP application and/or re-open the markdown file. Upgrade NPP may help.

Build Your Own UDL Files

The best way to build your own UDL file is to fork this repo. You need to install Node.js in your system.

:: In your dev folder
git clone https://github.com/Edditoria/markdown-plus-plus.git
cd markdown-plus-plus
npm install

:: Play around. Finally, run the build script
npm run build

For details, please read the document: build-workflow.md

Options

Options are reviewed in v3. In each config file in the config folder, you can adjust for your own build. Here are some examples:

OptionDescriptions
goodies.highlightHexHighlight HEX value.
flags.transparentBgMake the text background being transparent. :warning: Use it with caution
flags.asteriskUnorderedListEnable the markdown style of asterisk-style bullet points (* a \<li\> bullet point). :warning: Use it with caution

For details, please read the document: build-workflow.md

Key Changes from v2 to v3

Contribution

tl;tr For pull request, please merge from your new branch into my master branch (recommend enabling "Allow edits from maintainers"); Or, propose a file change in Github directly; Or, hit me a message via issue page or my social contacts.

For details, please kindly read CONTRIBUTING.md.

:beer: Thank you so much! :pray:

Copyright and License

Copyright for portions of this repository are held by Thomas Smits since 2010 as part of his repository. All other copyright are held by Edditoria since 2012.

Code released under the MIT License. Docs released under Creative Commons.

As human-readable summary (but not a substitute for the license):

You can use it, share it, modify the code and distribute your work for private and commercial uses. If you like, please share your work with me. :pizza: