Skip to content

About

A Notepad++ plugin for YAML ↔ Java Properties conversion, with automatic format detection and configurable output. | Notepad++ YAML 与 Java Properties 双向转换插件,支持自动识别格式及新标签页或原位输出。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

YamlProperties

Convert between YAML and Properties in Notepad++ with one click.

English · 简体中文

Windows build and release checks Windows x86, x64 and ARM64 GPL-3.0-or-later

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.

Example

YAML → Properties

server:
  port: 8080
logging:
  level:
    com.example: off
server.port=8080
logging.level.com.example=off

When 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 (中文) →

Installation

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
  1. Download the manual installation package ending in -x86.zip, -x64.zip, or -arm64.zip for 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.
  2. Close Notepad++, extract the package, and copy the YamlProperties folder into Notepad++'s plugins directory.
  3. Restart Notepad++ and open Plugins → YamlProperties.

The installed DLL should be at:

Notepad++/plugins/YamlProperties/YamlProperties.dll

Scripted installation, upgrades, and rollback (中文) →

Usage

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.

Documentation and contributing

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.


GPL-3.0-or-later · Third-party licenses

About

A Notepad++ plugin for YAML ↔ Java Properties conversion, with automatic format detection and configurable output. | Notepad++ YAML 与 Java Properties 双向转换插件,支持自动识别格式及新标签页或原位输出。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages