{
  "slug": "html-entity-decoder",
  "name": "gizza-ai/html-entity-decoder",
  "version": "0.1.0",
  "title": "HTML Entity Decoder — gizza.ai",
  "description": "Decode HTML character entities to plain text — named (&, ©, —), decimal (©), and hex (©) references in your browser.",
  "tags": [
    "html entity decoder",
    "html decode",
    "html unescape",
    "named entities",
    "numeric entities",
    "html character reference",
    "mdash",
    "nbsp",
    "unescape html"
  ],
  "category": "developer",
  "urls": {
    "page": "https://gizza.ai/tools/html-entity-decoder/",
    "markdown": "https://gizza.ai/tools/html-entity-decoder/index.md",
    "descriptor": "https://gizza.ai/tools/html-entity-decoder/tool.json",
    "deep_link_example": "https://gizza.ai/tools/html-entity-decoder/?text=Fish%20%26amp%3B%20Chips%20%26mdash%3B%20%26%23169%3B%202026%20%26%23x2122%3B&unknown=keep"
  },
  "cli": "gizza tool html-entity-decoder \"Fish & Chips — © 2026 ™\"",
  "tool": {
    "description": "Decode HTML character entities into their literal characters. Handles the full HTML5 named entity set (& © — …   ™ …), decimal numeric references (©), and hexadecimal ones (©), including the WHATWG rules: legacy entities that omit the trailing ';' (&copy → ©) and the Windows-1252 remap for code points 128–159 (so — → an em dash and € → €). Invalid code points become the replacement character U+FFFD. By default (unknown='keep') any reference it can't decode is left exactly as written; set unknown='error' to fail on the first unknown or malformed reference instead. To go the other way (turn characters INTO entities) use the string-escaper tool.",
    "parameters": {
      "additionalProperties": false,
      "properties": {
        "text": {
          "description": "The text containing HTML character entities to decode, e.g. 'Fish & Chips — © 2026'.",
          "type": "string"
        },
        "unknown": {
          "default": "keep",
          "description": "How to handle a reference that can't be decoded (an unrecognized named entity or a malformed numeric reference). 'keep' (default) leaves it exactly as written; 'error' fails and names the offender.",
          "enum": [
            "keep",
            "error"
          ],
          "type": "string"
        }
      },
      "required": [
        "text"
      ],
      "type": "object"
    }
  }
}