formatarc 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # 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. No config, no dependencies to manage — just pipe or pass your data.
 
 **Web version → [formatarc.com](https://formatarc.com)**
 
@@ -31,6 +31,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 +72,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,6 +116,7 @@ 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)
 

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,6 +76,58 @@ 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;
+})();
 function formatError(err, input, tool) {
     if (err instanceof YAML.YAMLParseError) {
         const line = err.linePos?.[0]?.line;
@@ -67,5 +141,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.0",
+  "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"
   }
 }