formatarc 0.1.0 → 0.2.1

package/README.md

@@ -1,8 +1,28 @@
 # formatarc
 
-Convert JSON, YAML, and CSV from the terminal. No config, no dependencies to manage — just pipe or pass your data.
+Convert JSON, YAML, CSV, Markdown, and HTML from the terminal — your data never leaves your machine. No config, no telemetry, no upload.
 
-**Web version → [formatarc.com](https://formatarc.com)**
+[![npm version](https://img.shields.io/npm/v/formatarc.svg)](https://www.npmjs.com/package/formatarc)
+[![license: MIT](https://img.shields.io/npm/l/formatarc.svg)](https://github.com/m-naoki-m/formatarc/blob/main/LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/formatarc.svg)](https://www.npmjs.com/package/formatarc)
+
+**Web version → [formatarc.com](https://formatarc.com)** — the same conversions, 100% in your browser, no signup.
+
+## Why formatarc?
+
+Most "online JSON / YAML / CSV converters" send the data you paste to a server. In November 2025, security firm watchTowr disclosed that two popular formatter sites (jsonformatter.org and codebeautify.org) had publicly exposed **over 80,000 saved submissions (5 GB+)** through a predictable "Recent Links" URL — including Active Directory credentials, cloud access keys, private keys, CI/CD secrets, JWTs, and full AWS Secrets Manager exports from government, banking, healthcare, and aerospace organizations. ([watchTowr report](https://labs.watchtowr.com/stop-putting-your-passwords-into-random-websites-yes-seriously-you-are-the-problem/))
+
+formatarc is built so that can't happen. The CLI runs entirely on your machine, and the [web version](https://formatarc.com) runs entirely in your browser — no upload, no logging, no telemetry, no account.
+
+It is not only paste-to-a-server sites, either: in early 2026, a widely used JSON formatter browser extension was reported (on Hacker News and dev.to) to add third-party tracking and checkout-page injection after moving to a closed-source model — a reminder that an installed extension can change behaviour through an automatic update. Background on both risks: [are online converters safe?](https://formatarc.com/en/blog/online-converter-safety/) and [picking a JSON formatter Chrome extension by privacy and permissions](https://formatarc.com/en/blog/chrome-extension-json-formatter/).
+
+| | formatarc CLI | formatarc web | Typical online converter | jq / yq / pandoc |
+|---|:---:|:---:|:---:|:---:|
+| Data stays local | ✅ | ✅ | ❌ | ✅ |
+| No signup / no upload | ✅ | ✅ | ⚠️ | ✅ |
+| JSON + YAML + CSV + Markdown + HTML in one tool | ✅ | ✅ | ⚠️ | ❌ |
+| Works offline | ✅ | after first load | ❌ | ✅ |
+| Single install | ✅ | n/a | n/a | ❌ |
 
 ## Install
 
@@ -31,6 +51,9 @@ cat file | formatarc <tool>
 | `yaml-to-json` | Convert YAML to JSON |
 | `json-to-yaml` | Convert JSON to YAML |
 | `csv-to-json` | Convert CSV (with header row) to JSON |
+| `csv-to-markdown` | Convert CSV to a Markdown (GFM) table |
+| `markdown-to-html` | Convert Markdown to HTML |
+| `html-to-markdown` | Convert HTML to Markdown |
 
 ### Examples
 
@@ -69,6 +92,24 @@ Convert CSV from stdin:
 cat users.csv | formatarc csv-to-json
 ```
 
+Convert CSV to a Markdown table:
+
+```bash
+cat users.csv | formatarc csv-to-markdown
+```
+
+Render Markdown as HTML:
+
+```bash
+cat README.md | formatarc markdown-to-html > README.html
+```
+
+Strip HTML to Markdown (handy for piping web pages into LLMs):
+
+```bash
+curl -s https://example.com | formatarc html-to-markdown
+```
+
 ## Programmatic API
 
 ```typescript
@@ -95,8 +136,11 @@ For a browser-based experience with no signup and no data upload:
 **[formatarc.com](https://formatarc.com)**
 
 - JSON Formatter, YAML ↔ JSON, CSV → JSON
+- CSV → Markdown, Markdown ↔ HTML
 - Runs entirely in the browser
-- Multilingual (English / Japanese)
+- Multilingual (English, Japanese, Spanish, Portuguese)
+
+There is also a [Chrome extension](https://formatarc.com/en/blog/chrome-extension-json-formatter/) for popup and right-click conversion — same browser-side processing, no upload.
 
 ## License
 

package/dist/cli.js

@@ -10,15 +10,21 @@ Usage:
   cat file | formatarc <tool>
 
 Tools:
-  json-format   Pretty-print JSON
-  yaml-to-json  Convert YAML to JSON
-  json-to-yaml  Convert JSON to YAML
-  csv-to-json   Convert CSV to JSON
+  json-format       Pretty-print JSON
+  yaml-to-json      Convert YAML to JSON
+  json-to-yaml      Convert JSON to YAML
+  csv-to-json       Convert CSV to JSON
+  csv-to-markdown   Convert CSV to a Markdown table
+  markdown-to-html  Convert Markdown to HTML
+  html-to-markdown  Convert HTML to Markdown
 
 Examples:
   formatarc json-format '{"a":1}'
   formatarc yaml-to-json config.yaml
   cat data.csv | formatarc csv-to-json
+  cat table.csv | formatarc csv-to-markdown
+  cat README.md | formatarc markdown-to-html
+  cat page.html | formatarc html-to-markdown
 
 Web version: https://formatarc.com
 `.trim();

package/dist/converter.d.ts

@@ -2,6 +2,6 @@ export type ConvertResult = {
     output: string;
     error: string;
 };
-export type Tool = "json-format" | "yaml-to-json" | "json-to-yaml" | "csv-to-json";
+export type Tool = "json-format" | "yaml-to-json" | "json-to-yaml" | "csv-to-json" | "csv-to-markdown" | "markdown-to-html" | "html-to-markdown";
 export declare function isValidTool(value: string): value is Tool;
 export declare function convert(tool: Tool, input: string): ConvertResult;

package/dist/converter.js

@@ -1,6 +1,16 @@
 import Papa from "papaparse";
 import YAML from "yaml";
-const TOOLS = ["json-format", "yaml-to-json", "json-to-yaml", "csv-to-json"];
+import { marked } from "marked";
+import TurndownService from "turndown";
+const TOOLS = [
+    "json-format",
+    "yaml-to-json",
+    "json-to-yaml",
+    "csv-to-json",
+    "csv-to-markdown",
+    "markdown-to-html",
+    "html-to-markdown",
+];
 export function isValidTool(value) {
     return TOOLS.includes(value);
 }
@@ -26,7 +36,19 @@ export function convert(tool, input) {
                     error: "",
                 };
             case "csv-to-json":
-                return convertCsv(input);
+                return convertCsvToJson(input);
+            case "csv-to-markdown":
+                return convertCsvToMarkdown(input);
+            case "markdown-to-html":
+                return {
+                    output: marked.parse(input, { async: false, gfm: true, breaks: false }),
+                    error: "",
+                };
+            case "html-to-markdown":
+                return {
+                    output: turndownService.turndown(input),
+                    error: "",
+                };
             default:
                 return { output: "", error: `Unknown tool: ${tool}` };
         }
@@ -35,7 +57,7 @@ export function convert(tool, input) {
         return { output: "", error: formatError(err, input, tool) };
     }
 }
-function convertCsv(input) {
+function convertCsvToJson(input) {
     const parsed = Papa.parse(input, {
         header: true,
         skipEmptyLines: "greedy",
@@ -54,12 +76,103 @@ function convertCsv(input) {
         error: "",
     };
 }
+function renderMarkdownTable(rows) {
+    const columnCount = rows[0].length;
+    const escapeCell = (value) => value.replace(/\r?\n/g, " ").replace(/\|/g, "\\|").trim();
+    const normalizeRow = (row) => {
+        const trimmed = row.length > columnCount ? row.slice(0, columnCount) : row;
+        const padded = trimmed.length === columnCount
+            ? trimmed
+            : [...trimmed, ...Array(columnCount - trimmed.length).fill("")];
+        return padded.map(escapeCell);
+    };
+    const renderRow = (cells) => `| ${cells.join(" | ")} |`;
+    const header = normalizeRow(rows[0]);
+    const separator = Array(columnCount).fill("---");
+    const body = rows.slice(1).map(normalizeRow);
+    return [renderRow(header), renderRow(separator), ...body.map(renderRow)].join("\n");
+}
+function convertCsvToMarkdown(input) {
+    const parsed = Papa.parse(input, {
+        header: false,
+        skipEmptyLines: "greedy",
+    });
+    if (parsed.errors.length > 0) {
+        const first = parsed.errors[0];
+        return { output: "", error: `CSV parse error: ${first.message}` };
+    }
+    const rows = parsed.data.filter((row) => row.length > 0);
+    if (rows.length === 0) {
+        return { output: "", error: "CSV is empty." };
+    }
+    return {
+        output: renderMarkdownTable(rows) + "\n",
+        error: "",
+    };
+}
+const turndownService = (() => {
+    const service = new TurndownService({
+        headingStyle: "atx",
+        codeBlockStyle: "fenced",
+        bulletListMarker: "-",
+        emDelimiter: "_",
+    });
+    service.addRule("table", {
+        filter: "table",
+        replacement: (_content, node) => {
+            const rows = Array.from(node.querySelectorAll("tr")).map((row) => Array.from(row.querySelectorAll("th, td")).map((cell) => cell.textContent ?? ""));
+            if (rows.length === 0)
+                return "";
+            return `\n\n${renderMarkdownTable(rows)}\n\n`;
+        },
+    });
+    return service;
+})();
+// Locate a trailing comma (a comma whose next non-whitespace character is `}`
+// or `]`). String-aware so commas/brackets inside string values are ignored.
+// Returns the comma's 1-based line, or null if there is none.
+function findTrailingCommaLine(input) {
+    let inString = false;
+    let escape = false;
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        if (inString) {
+            if (escape)
+                escape = false;
+            else if (ch === "\\")
+                escape = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            continue;
+        }
+        if (ch === ",") {
+            let j = i + 1;
+            while (j < input.length && /\s/.test(input[j]))
+                j++;
+            if (j < input.length && (input[j] === "}" || input[j] === "]")) {
+                return input.slice(0, i + 1).split("\n").length;
+            }
+        }
+    }
+    return null;
+}
 function formatError(err, input, tool) {
     if (err instanceof YAML.YAMLParseError) {
         const line = err.linePos?.[0]?.line;
         return line ? `YAML syntax error near line ${line}.` : "YAML syntax error.";
     }
     if (err instanceof Error && err.name === "SyntaxError") {
+        // Trailing comma is the most common JSON mistake, and parsers report it at
+        // the *following* bracket (often on the next line), not at the comma. Find
+        // the comma ourselves and point at its line.
+        const trailingCommaLine = findTrailingCommaLine(input);
+        if (trailingCommaLine !== null) {
+            return `Invalid JSON: remove the trailing comma on line ${trailingCommaLine}.`;
+        }
         const match = err.message.match(/position\s+(\d+)/i);
         if (match) {
             const line = input.slice(0, Number(match[1])).split("\n").length;
@@ -67,5 +180,11 @@ function formatError(err, input, tool) {
         }
         return "Invalid JSON.";
     }
+    if (tool === "markdown-to-html") {
+        return "Failed to parse Markdown. Check the syntax.";
+    }
+    if (tool === "html-to-markdown") {
+        return "Failed to parse HTML. Check for unclosed tags.";
+    }
     return "Failed to parse input. Check the format.";
 }

package/package.json

@@ -1,16 +1,21 @@
 {
   "name": "formatarc",
-  "version": "0.1.0",
-  "description": "Convert JSON, YAML, and CSV from the terminal. Browser-based version at formatarc.com.",
+  "version": "0.2.1",
+  "description": "Convert JSON, YAML, CSV, Markdown, and HTML from the terminal. Browser-based version at formatarc.com.",
   "keywords": [
     "json",
     "yaml",
     "csv",
+    "markdown",
+    "html",
     "formatter",
     "converter",
     "json-formatter",
     "yaml-to-json",
     "csv-to-json",
+    "csv-to-markdown",
+    "markdown-to-html",
+    "html-to-markdown",
     "cli"
   ],
   "author": "FormatArc",
@@ -36,11 +41,14 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "marked": "^18.0.1",
     "papaparse": "^5.5.2",
+    "turndown": "^7.2.4",
     "yaml": "^2.8.1"
   },
   "devDependencies": {
     "@types/papaparse": "^5.3.15",
+    "@types/turndown": "^5.0.6",
     "typescript": "^5.8.3"
   }
 }