json-to-plain-text

📖 Overview

json-to-plain-text is a lightweight npm package that converts JSON into a clean, human-readable plain-text.

Think of it as JSON.stringify(), but prettier, friendlier, and tailored for logs, debugging, and CLI output.

[!NOTE]
From version 2.0.0+, this package outputs plain text only.
If you need colored output, please use version 1.1.4 .

✨ Features

• 🔹 Convert JSON objects into easy-to-read plain text
• ⚡ Tiny & fast (zero dependencies)
• 🛠 Configurable separators, spacing, quotes, and array formatting
• ✅ Great for logs, debugging, reports, and CLI tools

🔍 Why use this?

Use json-to-plain-text when you need:

• 📑 Readable logs – no more squinting at raw JSON
• 🖥 CLI outputs – format objects neatly for the terminal
• 🧪 Debugging helpers – quickly inspect nested objects
• 📝 Reports/configs – human-friendly data printing

🚀 Installation

npm install json-to-plain-text

📦 Usage

import { jsonToPlainText } from "json-to-plain-text";

⚙️ API

jsonToPlainText(data: unknown, options?: Options): string

Parameters

• data (required) – JSON-like input or JavaScript object.
• options (optional) – Customize the formatting.

| Option | Type | Default | Description | |---------------------------|---------|---------|-------------| | separator | string | : | Character used between keys and values. | | spacing | boolean | true | Align keys with spacing before colons. | | squareBracketsForArray | boolean | false | Display arrays inside []. | | doubleQuotesForKeys | boolean | false | Wrap object keys in double quotes. | | doubleQuotesForValues | boolean | false | Wrap string values in double quotes. |

💡 Example

import { jsonToPlainText, Options } from "json-to-plain-text";

const data = {
  place_id: "173937105",
  osm_type: "way",
  lat: "17.861533866867224",
  lon: "78.8081441896764",
  address: {
    city: "Hyderabad",
    state: "Telangana",
    country: "India",
  },
  distance: 2,
};

const options: Options = {
  separator: ":",
  spacing: true,
  squareBracketsForArray: false,
  doubleQuotesForKeys: false,
  doubleQuotesForValues: false,
};

console.log(jsonToPlainText(data, options));

✅ Output

place_id : 173937105
osm_type : way
lat      : 17.861533866867224
lon      : 78.8081441896764
address  : 
city     : Hyderabad
state    : Telangana
country  : India
distance : 2

💝 Support

If this project helps you, consider supporting my open-source work:

• 💖 SPONSOR ME ON GITHUB

A huge thanks to all sponsors for supporting my work!

📜 License

This project is licensed under the MIT License.

👨‍💻 Author

• Sumith Emmadi