@dunkinfrunkin/mdcat 0.1.14 → 0.1.16

package/README.md

@@ -33,7 +33,9 @@ npx @dunkinfrunkin/mdcat README.md
 
 ```sh
 mdcat README.md                  # open a file
+mdcat file1.md file2.md file3.md # view multiple files
 mdcat --web README.md            # render and open in browser
+mdcat -p README.md               # plain text output (no TUI, no ANSI)
 mdcat -n README.md               # show line numbers
 mdcat --light README.md          # force light theme
 mdcat --dark README.md           # force dark theme
@@ -108,7 +110,7 @@ npm install
 npm test
 ```
 
-All PRs must pass `npm test` (85 tests).
+All PRs must pass `npm test` (97 tests).
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dunkinfrunkin/mdcat",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "View markdown files beautifully in your terminal",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -8,6 +8,7 @@ import { renderTokens, setTheme } from "./render.js";
 import { launch } from "./tui.js";
 import { toDocx } from "./docx.js";
 import { detectTheme, themeFromArgs, stripThemeArgs } from "./theme.js";
+import { concatFiles } from "./concat.js";
 
 marked.use({ gfm: true });
 
@@ -27,9 +28,10 @@ if (args[0] === "--help" || args[0] === "-h") {
   console.log(`\n${CAT}  ${bold("mdcat")} ${dim(`v${pkg.version}`)}`);
   console.log(`${dim("         markdown pager for your terminal")}\n`);
   console.log(`${bold("Usage:")}`);
-  console.log(`  mdcat ${dim("<file.md>")}`);
+  console.log(`  mdcat ${dim("<file.md> [file2.md ...]")}`);
   console.log(`  mdcat ${dim("--web <file.md>")}   ${dim("# open in browser")}`);
   console.log(`  mdcat ${dim("--doc <file.md>")}   ${dim("# export to .docx")}`);
+  console.log(`  mdcat ${dim("-p, --plain")}       ${dim("# plain output (no TUI, no ANSI)")}`);
   console.log(`  mdcat ${dim("--light")}           ${dim("# force light theme")}`);
   console.log(`  mdcat ${dim("--dark")}            ${dim("# force dark theme")}`);
   console.log(`  mdcat ${dim("-n, --number")}      ${dim("# show line numbers")}`);
@@ -50,6 +52,10 @@ const activeTheme = themeFromArgs(args) ?? detectTheme();
 args = stripThemeArgs(args);
 setTheme(activeTheme);
 
+// Plain mode flag
+const plainMode = args.includes("-p") || args.includes("--plain");
+args = args.filter(a => a !== "-p" && a !== "--plain");
+
 // Line numbers flag
 const showLineNumbers = args.includes("-n") || args.includes("--number");
 args = args.filter(a => a !== "-n" && a !== "--number");
@@ -61,6 +67,22 @@ if (args[0] === "--version" || args[0] === "-v") {
 
 const MAX_COLS = 100;
 
+/** Strip ANSI SGR sequences and OSC 8 hyperlinks for plain text output. */
+function stripAnsi(s) {
+  return s
+    .replace(/\x1B\]8;;.*?\x1B\\/gs, "")
+    .replace(/\x1B\[[0-9;]*m/g, "");
+}
+
+function runPlain(content) {
+  const cols = Math.min(process.stdout.columns || 80, MAX_COLS);
+  const tokens = marked.lexer(content);
+  const lines = renderTokens(tokens, cols);
+  for (const line of lines) {
+    console.log(stripAnsi(line));
+  }
+}
+
 function escapeHtml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
@@ -158,22 +180,30 @@ if (!process.stdin.isTTY && fileArgs.length === 0) {
   process.stdin.on("end", () => {
     if (docMode) exportDocx("stdin", input);
     else if (webMode) openInBrowser("stdin", input);
+    else if (plainMode) runPlain(input);
     else runTUI("stdin", input);
   });
 } else if (fileArgs.length === 0) {
-  console.error("Usage: mdcat <file.md>");
+  console.error("Usage: mdcat <file.md> [file2.md ...]");
   process.exit(1);
 } else {
-  const filePath = resolve(fileArgs[0]);
-  let content;
-  try {
-    content = readFileSync(filePath, "utf8");
-  } catch (err) {
-    console.error(`mdcat: ${fileArgs[0]}: ${err.code === "ENOENT" ? "No such file" : err.message}`);
-    process.exit(1);
+  const parts = [];
+  for (const arg of fileArgs) {
+    const filePath = resolve(arg);
+    let text;
+    try {
+      text = readFileSync(filePath, "utf8");
+    } catch (err) {
+      console.error(`mdcat: ${arg}: ${err.code === "ENOENT" ? "No such file" : err.message}`);
+      process.exit(1);
+    }
+    parts.push({ name: basename(filePath), content: text });
   }
-  const title = basename(filePath);
+
+  const { title, content } = concatFiles(parts);
+
   if (docMode) exportDocx(title, content);
   else if (webMode) openInBrowser(title, content);
+  else if (plainMode) runPlain(content);
   else runTUI(title, content);
 }

package/src/concat.js

@@ -0,0 +1,16 @@
+/**
+ * Concatenate multiple file entries into a single markdown document.
+ * Each entry is { name, content }. When there is more than one file,
+ * a `## filename` heading and `---` separator are inserted between files.
+ * Returns { title, content }.
+ */
+export function concatFiles(parts) {
+  if (parts.length === 0) return { title: "", content: "" };
+  if (parts.length === 1) return { title: parts[0].name, content: parts[0].content };
+  return {
+    title: `${parts.length} files`,
+    content: parts
+      .map(p => `## ${p.name}\n\n${p.content}`)
+      .join("\n\n---\n\n"),
+  };
+}