Convert between YAML and Properties in Notepad++ with one click.
English · 简体中文
Installation · Usage · User guide (中文) · Report an issue
- Convert both ways: YAML ↔ Properties, with optional automatic format detection.
- Choose what to convert: process a selection or the entire document, and open the result in a new tab or replace the original text.
- Handle special keys: supports keys such as
com.example, Chinese characters, spaces, and escape sequences. - Run locally: native x86, x64 and ARM64 plugins; conversion requires no network connection.
- Follow the editor language: menus, configuration-save messages and About switch immediately with the Notepad++ UI language. Supports English, Simplified Chinese and Traditional Chinese; other languages fall back to English.
YAML → Properties
server:
port: 8080
logging:
level:
com.example: offserver.port=8080
logging.level.com.example=offWhen converting back, dots expand into nested keys by default, except that logger names beneath logging.level remain complete keys (for example, com.example and com.example.dao.Mapper can coexist). Existing quotes in Properties are retained as YAML syntax and no new quotes are added, including for 00123, true, or off. YAML double-quoted values also keep their quotes in Properties: name: "demo" becomes name="demo". YAML escape spellings are retained with Java Properties escaping; multiline double-quoted values become a quoted single line. Other original key grouping, comments, and formatting are not preserved. Conversion rules (中文) →
Supports 32-Bit (x86), 64-Bit (x64), and 64-Bit ARM (ARM64) Notepad++. Match the plugin to the architecture of Notepad++, not just Windows.
| Notepad++ edition | Manual package suffix |
|---|---|
| 32-Bit | -x86.zip |
| 64-Bit | -x64.zip |
| 64-Bit ARM | -arm64.zip |
- Download the manual installation package ending in
-x86.zip,-x64.zip, or-arm64.zipfor your Notepad++ edition from Releases. If your architecture is not in a published release yet, download its build artifact from a successful Actions run and extract it to find the ZIP. - Close Notepad++, extract the package, and copy the
YamlPropertiesfolder into Notepad++'spluginsdirectory. - Restart Notepad++ and open Plugins → YamlProperties.
The installed DLL should be at:
Notepad++/plugins/YamlProperties/YamlProperties.dll
Scripted installation, upgrades, and rollback (中文) →
Open a configuration file and select Plugins → YamlProperties → 自动识别并转换 (automatically detect and convert), or choose YAML → Properties / Properties → YAML explicitly.
If text is selected, only that selection is converted; otherwise, the whole document is converted. By default, the result opens in a new tab and the original text is preserved.
The output option uses a Chinese menu label:
| Menu option | Behavior |
|---|---|
| 在新标签页打开转换结果 (open results in a new tab) | Enabled by default. Disable it to replace text in place; press Ctrl+Z to undo the converted text in one step. |
| 转换时按键名排序 (sort keys during conversion) | Disabled by default. Enable case-sensitive ascending key order within each mapping, in either direction. Array element order and quote handling stay unchanged. |
Both preferences persist across restarts. Sorting runs only when converting; it does not run while editing or saving. Keys use Unicode character order, not pinyin or natural-number order (key10 comes before key2); array indices retain numeric order. Automatic detection prioritizes the file extension; use an explicit conversion command when the format is ambiguous.
The detailed guides below are in Chinese:
User guide · Build from source · Release guide · Changelog (English)
Issues and pull requests are welcome. When reporting a conversion problem, include a minimal input sample, the expected result, and your Notepad++ version. Remove real passwords and other sensitive configuration values from samples.
Release builds run entirely in GitHub Actions: pushing a version tag builds and tests x86, x64 and ARM64, then publishes the verified packages to GitHub Releases. See the release guide.
After publication, Actions updates the open official plugin-list PR or creates a new one if the previous PR was merged. Configure the NPP_PLUGIN_LIST_TOKEN repository secret once for cross-repository submissions; the release guide includes setup and manual retry instructions. Official maintainer approval is still required.