@entro314labs/markdownfix 0.0.6

package/.remarkignore

@@ -0,0 +1,59 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build outputs
+dist/
+build/
+out/
+.next/
+.nuxt/
+.cache/
+
+# Environment files
+.env*
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+.tmp/
+temp/
+*.tmp
+
+# Package manager files
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# Git files
+.git/
+.gitignore
+
+# Backup files
+*.backup
+*.bak
+*~
+
+# Coverage reports
+coverage/
+.nyc_output/
+
+# Specific files to ignore
+CHANGELOG.md
+LICENSE
+README.md

package/.remarkrc.js

@@ -0,0 +1,83 @@
+/**
+ * Opinionated Remark configuration for markdown processing
+ * Supports .md, and .mdx files with consistent formatting
+ * Optionally supports .mdd files if mdd package is installed
+ */
+
+// Try to load MDD plugins if available
+let mddPlugins = [];
+try {
+  const mddDocStructure = await import('@entro314labs/mdd/plugins/remark-mdd-document-structure.js');
+  const mddTextFormatting = await import('@entro314labs/mdd/plugins/remark-mdd-text-formatting.js');
+  const mddMdxConditional = await import('@entro314labs/mdd/plugins/remark-mdx-conditional.js');
+
+  mddPlugins = [
+    mddMdxConditional.default,
+    mddDocStructure.default,
+    mddTextFormatting.default
+  ];
+  console.log('✓ MDD support enabled');
+} catch (e) {
+  // MDD package not installed - only support .md and .mdx
+  mddPlugins = ['remark-mdx'];
+  console.log('ℹ MDD support not available (install mdd package for .mdd file support)');
+}
+
+export default {
+  // Configure remark-stringify output formatting
+  settings: {
+    bullet: '-', // Use - for unordered lists
+    bulletOther: '*', // Use * for nested lists
+    bulletOrdered: '.', // Use 1. 2. 3. for ordered lists
+    emphasis: '_', // Use _emphasis_ over *emphasis*
+    strong: '*', // Use **strong** over __strong__
+    fence: '`', // Use ``` for code fences
+    fences: true, // Always use fences for code blocks
+    incrementListMarker: true, // Increment ordered list markers
+    listItemIndent: 'one', // Use one space for list indentation
+    quote: '"', // Use double quotes in titles
+    rule: '-', // Use --- for horizontal rules
+    ruleRepetition: 3, // Use exactly 3 characters for rules
+    ruleSpaces: false, // No spaces in horizontal rules
+    setext: false, // Use # instead of === underlines
+    tightDefinitions: true, // No blank lines between definitions
+  },
+
+  plugins: [
+    // Enable support for frontmatter (---, +++)
+    'remark-frontmatter',
+
+    // Enable GitHub Flavored Markdown (tables, strikethrough, etc.)
+    'remark-gfm',
+
+    // MDX/MDD plugins (loaded dynamically above)
+    ...mddPlugins,
+
+    // Apply consistent style presets
+    'remark-preset-lint-consistent',
+    'remark-preset-lint-recommended',
+    'remark-preset-lint-markdown-style-guide',
+
+    // Lint rules
+    ['remark-lint-heading-increment', true], // MD001
+    ['remark-lint-no-duplicate-headings', true], // MD024
+    ['remark-lint-no-emphasis-as-heading', true], // MD036
+    ['remark-lint-emphasis-marker', '_'],
+    ['remark-lint-strong-marker', '*'],
+    ['remark-lint-heading-style', 'atx'],
+    ['remark-lint-list-item-indent', 'one'],
+    ['remark-lint-ordered-list-marker-style', '.'],
+    ['remark-lint-ordered-list-marker-value', 'ordered'],
+    ['remark-lint-unordered-list-marker-style', '-'],
+    ['remark-lint-table-cell-padding', 'padded'],
+    ['remark-lint-table-pipe-alignment', true],
+    ['remark-lint-link-title-style', '"'],
+    ['remark-lint-no-trailing-spaces', true],
+    ['remark-lint-final-newline', true],
+    ['remark-lint-hard-break-spaces', true],
+    ['remark-lint-no-empty-sections', true],
+
+    // Must be last - handles the output formatting
+    'remark-stringify'
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Entro314 Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,346 @@
+# Markdown Formatter (markdownfix)
+
+**Opinionated markdown formatter and linter for `.md`, `.mdd`, and `.mdx` files**
+
+Built on the Remark ecosystem with strict, consistent formatting rules for developer documentation, technical writing, and web content. Perfect for README files, technical docs, blogs, and GitHub wikis.
+
+## Features
+
+- ✅ **Opinionated formatting** - Consistent style across all markdown files
+- ✅ **GitHub Flavored Markdown** - Tables, task lists, strikethrough, autolinks
+- ✅ **MDX support** - JSX components in markdown
+- ✅ **Comprehensive linting** - 40+ lint rules for quality and consistency
+- ✅ **Link validation** - Check for broken links
+- ✅ **Auto-fixing** - Automatically fix formatting issues
+
+## Installation
+
+```bash
+# Install globally
+npm install -g markdownfix
+
+# Or use with npx (no installation)
+npx markdownfix --help
+```
+
+## Quick Start
+
+```bash
+# Format all markdown files in current directory
+markdownfix format
+
+# Check formatting without writing changes
+markdownfix check
+
+# Lint files for issues
+markdownfix lint
+
+# Format specific files
+markdownfix format README.md docs/*.md
+
+# Use glob patterns
+markdownfix format --glob "src/**/*.md"
+
+# Quiet mode (suppress output)
+markdownfix format --quiet
+```
+
+### Using as a Package Script
+
+Add to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "format:md": "markdownfix format",
+    "lint:md": "markdownfix lint"
+  }
+}
+```
+
+### Initialize Project
+
+```bash
+# Create .remarkrc.js configuration
+markdownfix init
+
+# Create example content structure
+markdownfix setup
+```
+
+## What Gets Formatted
+
+### Lists
+- **Unordered**: `-` (never `*` or `+`)
+- **Ordered**: `1.` incremental (never `1)`)
+
+### Emphasis
+- **Italic**: `_text_` (underscore, not asterisk)
+- **Bold**: `**text**` (double asterisk, not underscore)
+
+### Headings
+- **Style**: ATX (`# Title`), never setext (`===`)
+- **Hierarchy**: Must progress sequentially (no skipping levels)
+
+### Code Blocks
+- Always fenced (` ``` `) with language identifiers
+- Never indented code blocks
+
+### Formatting
+- **Line length**: 100 characters max with smart wrapping
+- **Tables**: Padded cells with aligned pipes (auto-formatted)
+- **Final newline**: All files must end with `\n`
+- **No trailing spaces**: Automatically removed
+
+## File Support
+
+| Extension | Support | Features | Use Case |
+|-----------|---------|----------|----------|
+| `.md` | ✅ Full | GFM, frontmatter, tables, task lists | Documentation, READMEs, blogs |
+| `.mdx` | ✅ Full | Above + JSX components, imports/exports | React docs, interactive content |
+| `.mdd` | ⚠️ Optional | Business documents (see below) | Invoices, proposals, contracts |
+
+### MDD Support
+
+This formatter can **optionally** format `.mdd` files if you install the [MDD package](https://www.npmjs.com/package/@entro314labs/mdd):
+
+```bash
+# Install MDD support
+pnpm add mdd
+
+# Now .mdd files will be formatted
+pnpm run format
+```
+
+**Note**: MDD is a separate project for business documents. See the [MDD project](https://github.com/entro314-labs/mdd) for details.
+
+## CLI Commands
+
+### Available Commands
+
+```bash
+markdownfix format [files...]   # Format and fix markdown files
+markdownfix check [files...]    # Check without writing changes
+markdownfix lint [files...]     # Lint for issues only
+markdownfix init               # Create .remarkrc.js config
+markdownfix setup              # Create example content structure
+```
+
+### Command Aliases
+
+The CLI is available via two commands:
+
+- `markdownfix` (full name)
+- `mdfix` (short alias)
+
+```bash
+# These are equivalent
+markdownfix format
+mdfix format
+```
+
+### Options
+
+```bash
+--help, -h         Show help message
+--version, -v      Show version number
+--quiet, -q        Suppress output except errors
+--glob <pattern>   Use glob pattern for file matching
+```
+
+### Examples
+
+```bash
+# Format all markdown in project
+mdfix format
+
+# Check specific files
+mdfix check README.md CHANGELOG.md
+
+# Lint with glob pattern
+mdfix lint --glob "docs/**/*.{md,mdx}"
+
+# Quiet formatting
+mdfix format --quiet
+
+# Get help
+mdfix --help
+```
+
+## Development Scripts
+
+If you're working on the markdownfix project itself:
+
+```bash
+# Formatting
+pnpm run format         # Apply fixes using remark-cli
+pnpm run format:check   # Preview changes
+
+# Linting
+pnpm run lint           # Check compliance
+
+# Combined
+pnpm run process        # Format then lint
+pnpm run process:safe   # Dry-run first, then process
+pnpm test               # Same as process:safe
+
+# Utilities
+pnpm run check-links    # Validate all markdown links
+pnpm run clean-cache    # Clear remark cache
+```
+
+## Project Structure
+
+```
+markdownfix/
+├── content/            # Example content
+│   ├── docs/
+│   ├── blog/
+│   └── guides/
+├── .remarkrc.js        # Formatting & linting rules
+├── .remarkignore       # Files to exclude
+├── setup.js            # Bootstrap script
+├── package.json
+└── README.md
+```
+
+## Configuration
+
+### `.remarkrc.js`
+
+Central configuration defining:
+- All formatting rules
+- Plugin chain order
+- Lint rule settings
+
+**Plugin order is critical:**
+1. `remark-frontmatter` - Parse YAML/TOML
+2. `remark-gfm` - GitHub Flavored Markdown
+3. `remark-mdx` - MDX support (conditional)
+4. Lint presets + rules
+5. `remark-stringify` - Must be last
+
+### `.remarkignore`
+
+Files excluded from processing:
+- `README.md`
+- `CHANGELOG.md`
+- `LICENSE`
+- `node_modules/`
+- `pnpm-lock.yaml`
+
+## Frontmatter Convention
+
+```yaml
+---
+title: Required for all content files
+date: YYYY-MM-DD format preferred
+author: Optional but recommended
+---
+```
+
+## Common Issues
+
+### "No input" Errors
+
+**Cause**: No markdown files found or all files excluded
+
+**Solution**:
+- Ensure markdown files exist in `content/` directory
+- Check `.remarkignore` patterns
+- Verify correct file extensions (`.md`, `.mdx`)
+
+### Linting Failures After Formatting
+
+**Cause**: Some rules require manual fixes (duplicate headings, broken links)
+
+**Solution**:
+- Read console output for specific violations
+- Manually fix reported issues
+- Use `pnpm run format:check` to separate formatting from lint errors
+
+### MDX Parsing Errors
+
+**Cause**: Invalid JSX syntax
+
+**Solution**:
+- Verify JSX is valid JavaScript
+- Check all tags are properly closed
+- Ensure React components use `<Component />` not `<Component>`
+
+## Bootstrap New Project
+
+```bash
+# Create example content structure
+node setup.js
+
+# Install dependencies
+pnpm install
+
+# Verify everything works
+pnpm run process:safe
+```
+
+## Editor Integration
+
+**Disable VS Code remark extensions** - they may conflict with this opinionated configuration. Always use command line processing.
+
+## Two Projects, One Ecosystem
+
+This repository focuses on **developer documentation** (READMEs, technical docs, blogs).
+
+For **business documents** (invoices, proposals, letters, contracts), we have a companion project:
+
+### 📄 [MDD (Markdown Document)](https://github.com/entro314-labs/mdd)
+
+MDD extends markdown with business-focused features:
+
+- Letterheads and headers/footers
+- Signature blocks
+- Contact information blocks
+- Professional PDF/DOCX output
+- Invoice and proposal templates
+
+```bash
+# Quick example
+cd ../mdd
+pnpm run preview examples/invoice.mdd
+# Opens professional HTML invoice in browser
+```
+
+**When to use which:**
+
+| Use Case | Project | File Type |
+|----------|---------|-----------|
+| README files | Markdown Formatter | `.md` |
+| Technical docs | Markdown Formatter | `.md` |
+| Blog posts | Markdown Formatter | `.md` / `.mdx` |
+| React documentation | Markdown Formatter | `.mdx` |
+| **Business letters** | **MDD** | `.mdd` |
+| **Invoices** | **MDD** | `.mdd` |
+| **Proposals** | **MDD** | `.mdd` |
+| **Contracts** | **MDD** | `.mdd` |
+
+## Documentation
+
+- **[COMPREHENSIVE-GUIDE.md](COMPREHENSIVE-GUIDE.md)** - Detailed technical guide
+- **[content/guides/style-guide.md](content/guides/style-guide.md)** - Style specifications
+
+## Tech Stack
+
+- **Remark** - Markdown processor
+- **Unified** - AST transformation
+- **GFM** - GitHub Flavored Markdown
+- **MDX** - JSX in markdown
+
+## Contributing
+
+This is an opinionated formatter with specific style decisions. Contributions should:
+- Maintain existing formatting rules
+- Add value for developer documentation
+- Not break existing lint rules
+- Include test cases
+
+## License
+
+MIT

package/cli.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+
+/**
+ * CLI tool for markdown formatting and linting
+ * Provides commands to format, lint, and check markdown files
+ */
+
+import { remark } from 'remark';
+import { read } from 'to-vfile';
+import { reporter } from 'vfile-reporter';
+import remarkPresetLintRecommended from 'remark-preset-lint-recommended';
+import remarkPresetLintConsistent from 'remark-preset-lint-consistent';
+import remarkPresetLintMarkdownStyleGuide from 'remark-preset-lint-markdown-style-guide';
+import remarkFrontmatter from 'remark-frontmatter';
+import remarkGfm from 'remark-gfm';
+import remarkStringify from 'remark-stringify';
+import fs from 'fs/promises';
+import path from 'path';
+import { glob } from 'glob';
+
+const MARKDOWN_EXTENSIONS = ['md', 'mdx', 'mdd'];
+
+// Import configuration from .remarkrc.js
+let remarkConfig;
+try {
+  const configModule = await import(path.join(process.cwd(), '.remarkrc.js'));
+  remarkConfig = configModule.default;
+} catch (e) {
+  console.warn('⚠️  No .remarkrc.js found in current directory, using default config');
+  remarkConfig = null;
+}
+
+/**
+ * Show help text
+ */
+function showHelp() {
+  console.log(`
+markdownfix - Opinionated markdown formatter and linter
+
+USAGE:
+  markdownfix <command> [options] [files...]
+
+COMMANDS:
+  format [files]     Format markdown files (writes changes)
+  check [files]      Check formatting without writing changes
+  lint [files]       Lint markdown files (no formatting)
+  init               Create .remarkrc.js configuration file
+  setup              Create example content structure
+
+OPTIONS:
+  --help, -h         Show this help message
+  --version, -v      Show version number
+  --quiet, -q        Suppress output except errors
+  --glob <pattern>   Use glob pattern (e.g., "**/*.md")
+
+EXAMPLES:
+  # Format all markdown files in current directory
+  markdownfix format
+
+  # Check specific files
+  markdownfix check README.md docs/*.md
+
+  # Lint with glob pattern
+  markdownfix lint --glob "src/**/*.md"
+
+  # Format quietly
+  markdownfix format --quiet
+
+  # Initialize configuration
+  markdownfix init
+
+For more information, visit: https://github.com/entro314-labs/markdownfix
+`);
+}
+
+/**
+ * Get files to process
+ */
+async function getFiles(args, globPattern) {
+  if (globPattern) {
+    return glob(globPattern, { ignore: 'node_modules/**' });
+  }
+
+  if (args.length > 0) {
+    return args;
+  }
+
+  // Default: find all markdown files in current directory and subdirectories
+  const patterns = MARKDOWN_EXTENSIONS.map(ext => `**/*.${ext}`);
+  const allFiles = [];
+
+  for (const pattern of patterns) {
+    const files = await glob(pattern, { ignore: ['node_modules/**', '.git/**'] });
+    allFiles.push(...files);
+  }
+
+  return allFiles;
+}
+
+/**
+ * Process files with remark
+ */
+async function processFiles(files, options = {}) {
+  const { write = false, quiet = false, lintOnly = false } = options;
+
+  let hasErrors = false;
+  let processedCount = 0;
+
+  for (const filePath of files) {
+    try {
+      const file = await read(filePath);
+
+      // Build processor
+      let processor = remark()
+        .use(remarkFrontmatter, ['yaml'])
+        .use(remarkGfm);
+
+      // Add lint presets
+      processor = processor
+        .use(remarkPresetLintRecommended)
+        .use(remarkPresetLintConsistent)
+        .use(remarkPresetLintMarkdownStyleGuide);
+
+      // Add stringify for formatting (unless lint-only)
+      if (!lintOnly) {
+        processor = processor.use(remarkStringify, {
+          bullet: '-',
+          emphasis: '_',
+          fences: true,
+          listItemIndent: 'one',
+          rule: '-',
+          strong: '*',
+          tightDefinitions: true
+        });
+      }
+
+      const result = await processor.process(file);
+
+      // Check for lint errors/warnings
+      if (result.messages.length > 0) {
+        if (!quiet) {
+          console.error(reporter(result));
+        }
+        hasErrors = true;
+      }
+
+      // Write changes if requested and not lint-only
+      if (write && !lintOnly) {
+        await fs.writeFile(filePath, String(result));
+        if (!quiet) {
+          console.log(`✓ Formatted: ${filePath}`);
+        }
+        processedCount++;
+      } else if (!write && !lintOnly && !quiet) {
+        // Preview mode
+        console.log(`\n${'='.repeat(60)}`);
+        console.log(`File: ${filePath}`);
+        console.log('='.repeat(60));
+        console.log(String(result));
+      }
+
+    } catch (error) {
+      console.error(`✗ Error processing ${filePath}:`, error.message);
+      hasErrors = true;
+    }
+  }
+
+  return { hasErrors, processedCount, totalFiles: files.length };
+}
+
+/**
+ * Initialize .remarkrc.js configuration
+ */
+async function initConfig() {
+  const configPath = path.join(process.cwd(), '.remarkrc.js');
+
+  try {
+    await fs.access(configPath);
+    console.log('⚠️  .remarkrc.js already exists');
+    return;
+  } catch {
+    // File doesn't exist, create it
+  }
+
+  const configContent = `/**
+ * Remark configuration for markdown formatting and linting
+ * @see https://github.com/remarkjs/remark
+ */
+
+export default {
+  plugins: [
+    // Frontmatter support
+    ['remark-frontmatter', ['yaml']],
+
+    // GitHub Flavored Markdown
+    'remark-gfm',
+
+    // Presets
+    'remark-preset-lint-recommended',
+    'remark-preset-lint-consistent',
+    'remark-preset-lint-markdown-style-guide',
+
+    // Formatting rules
+    ['remark-lint-emphasis-marker', '_'],
+    ['remark-lint-strong-marker', '*'],
+    ['remark-lint-unordered-list-marker-style', '-'],
+    ['remark-lint-ordered-list-marker-style', '.'],
+    ['remark-lint-maximum-line-length', 100],
+
+    // Stringify options for formatting
+    ['remark-stringify', {
+      bullet: '-',
+      emphasis: '_',
+      fences: true,
+      listItemIndent: 'one',
+      rule: '-',
+      strong: '*',
+      tightDefinitions: true
+    }]
+  ]
+};
+`;
+
+  await fs.writeFile(configPath, configContent);
+  console.log('✓ Created .remarkrc.js configuration file');
+}
+
+/**
+ * Main CLI entry point
+ */
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Handle version
+  if (args.includes('--version') || args.includes('-v')) {
+    const pkg = JSON.parse(await fs.readFile(new URL('./package.json', import.meta.url), 'utf-8'));
+    console.log(pkg.version);
+    return;
+  }
+
+  // Handle help
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
+  }
+
+  const command = args[0];
+  const commandArgs = args.slice(1);
+
+  // Parse options
+  const options = {
+    quiet: commandArgs.includes('--quiet') || commandArgs.includes('-q'),
+    glob: null
+  };
+
+  // Extract glob pattern
+  const globIndex = commandArgs.findIndex(arg => arg === '--glob');
+  if (globIndex !== -1 && commandArgs[globIndex + 1]) {
+    options.glob = commandArgs[globIndex + 1];
+  }
+
+  // Filter out option flags to get file arguments
+  const fileArgs = commandArgs.filter(arg =>
+    !arg.startsWith('--') &&
+    !arg.startsWith('-') &&
+    arg !== options.glob
+  );
+
+  // Execute command
+  switch (command) {
+    case 'format': {
+      const files = await getFiles(fileArgs, options.glob);
+      if (files.length === 0) {
+        console.log('No markdown files found');
+        return;
+      }
+      if (!options.quiet) {
+        console.log(`Formatting ${files.length} file(s)...`);
+      }
+      const result = await processFiles(files, { write: true, quiet: options.quiet });
+      if (!options.quiet) {
+        console.log(`\n✓ Formatted ${result.processedCount} of ${result.totalFiles} files`);
+      }
+      process.exit(result.hasErrors ? 1 : 0);
+      break;
+    }
+
+    case 'check': {
+      const files = await getFiles(fileArgs, options.glob);
+      if (files.length === 0) {
+        console.log('No markdown files found');
+        return;
+      }
+      if (!options.quiet) {
+        console.log(`Checking ${files.length} file(s)...`);
+      }
+      const result = await processFiles(files, { write: false, quiet: options.quiet });
+      if (!options.quiet) {
+        console.log(`\n${result.hasErrors ? '✗' : '✓'} Checked ${result.totalFiles} files`);
+      }
+      process.exit(result.hasErrors ? 1 : 0);
+      break;
+    }
+
+    case 'lint': {
+      const files = await getFiles(fileArgs, options.glob);
+      if (files.length === 0) {
+        console.log('No markdown files found');
+        return;
+      }
+      if (!options.quiet) {
+        console.log(`Linting ${files.length} file(s)...`);
+      }
+      const result = await processFiles(files, { lintOnly: true, quiet: options.quiet });
+      if (!options.quiet) {
+        console.log(`\n${result.hasErrors ? '✗' : '✓'} Linted ${result.totalFiles} files`);
+      }
+      process.exit(result.hasErrors ? 1 : 0);
+      break;
+    }
+
+    case 'init': {
+      await initConfig();
+      break;
+    }
+
+    case 'setup': {
+      // Import and run setup.js
+      const setupPath = new URL('./setup.js', import.meta.url);
+      await import(setupPath);
+      break;
+    }
+
+    default:
+      console.error(`Unknown command: ${command}`);
+      console.error('Run "markdownfix --help" for usage information');
+      process.exit(1);
+  }
+}
+
+main().catch(error => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "@entro314labs/markdownfix",
+  "version": "0.0.6",
+  "description": "Opinionated markdown formatter and linter for MD, MDD and MDX files using Remark/Unified ecosystem",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/entro314-labs/markdownfix.git"
+  },
+  "homepage": "https://github.com/entro314-labs/markdownfix#readme",
+  "bugs": {
+    "url": "https://github.com/entro314-labs/markdownfix/issues"
+  },
+  "files": [
+    ".remarkrc.js",
+    ".remarkignore",
+    "setup.js",
+    "cli.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "markdownfix": "./cli.js",
+    "mdfix": "./cli.js",
+    "markdownfix-setup": "./setup.js"
+  },
+  "keywords": [
+    "markdown",
+    "mdx",
+    "mdd",
+    "linter",
+    "formatter",
+    "remark",
+    "gfm",
+    "unified",
+    "markdownfix",
+    "markdown-linter",
+    "opinionated"
+  ],
+  "author": "Dominikos Pritis",
+  "license": "MIT",
+  "devDependencies": {
+    "markdown-link-check": "^3.14.1",
+    "remark-cli": "^12.0.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@adobe/remark-gridtables": "^3.0.15",
+    "@code-dot-org/remark-plugins": "^2.0.0",
+    "@entro314labs/mdd": "^0.0.6",
+    "@theguild/remark-mermaid": "^0.3.0",
+    "fumadocs-docgen": "^3.0.2",
+    "glob": "^11.0.3",
+    "js-yaml": "^4.1.0",
+    "rehype-remark": "^10.0.1",
+    "remark": "^15.0.1",
+    "remark-directive": "^4.0.0",
+    "remark-docx": "^0.1.8",
+    "remark-emoji": "^5.0.2",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-html": "^16.0.1",
+    "remark-linkify": "^1.1.0",
+    "remark-lint": "^10.0.1",
+    "remark-lint-alphabetize-lists": "^3.0.0",
+    "remark-lint-definition-case": "^4.0.1",
+    "remark-lint-emphasis-marker": "^4.0.1",
+    "remark-lint-final-newline": "^3.0.1",
+    "remark-lint-frontmatter-schema": "^3.15.4",
+    "remark-lint-hard-break-spaces": "^4.1.1",
+    "remark-lint-heading-capitalization": "^1.3.0",
+    "remark-lint-heading-increment": "^4.0.1",
+    "remark-lint-heading-style": "^4.0.1",
+    "remark-lint-link-title-style": "^4.0.1",
+    "remark-lint-list-item-bullet-indent": "^5.0.1",
+    "remark-lint-list-item-indent": "^4.0.1",
+    "remark-lint-list-item-style": "^3.0.1",
+    "remark-lint-match-punctuation": "^0.2.1",
+    "remark-lint-maximum-line-length": "^4.1.1",
+    "remark-lint-mdash-style": "^1.1.1",
+    "remark-lint-mdx-jsx-attribute-sort": "^1.0.1",
+    "remark-lint-mdx-jsx-no-void-children": "^1.0.1",
+    "remark-lint-mdx-jsx-quote-style": "^1.0.1",
+    "remark-lint-mdx-jsx-self-close": "^1.0.1",
+    "remark-lint-no-dead-urls": "^2.0.1",
+    "remark-lint-no-duplicate-headings": "^4.0.1",
+    "remark-lint-no-duplicate-headings-in-section": "^4.0.1",
+    "remark-lint-no-emphasis-as-heading": "^4.0.1",
+    "remark-lint-no-empty-sections": "^4.0.0",
+    "remark-lint-no-heading-indent": "^5.0.1",
+    "remark-lint-no-heading-punctuation": "^4.0.1",
+    "remark-lint-no-trailing-spaces": "^3.0.2",
+    "remark-lint-ordered-list-marker-style": "^4.0.1",
+    "remark-lint-ordered-list-marker-value": "^4.0.1",
+    "remark-lint-strong-marker": "^4.0.1",
+    "remark-lint-table-cell-padding": "^5.1.1",
+    "remark-lint-table-pipe-alignment": "^4.1.1",
+    "remark-lint-table-pipes": "^5.0.1",
+    "remark-lint-unordered-list-marker-style": "^4.0.1",
+    "remark-mdc": "^3.7.0",
+    "remark-mdx": "^3.1.1",
+    "remark-mdx-frontmatter": "^5.2.0",
+    "remark-preset-lint-consistent": "^6.0.1",
+    "remark-preset-lint-markdown-style-guide": "^6.0.1",
+    "remark-preset-lint-recommended": "^7.0.1",
+    "remark-preset-remcohaszing": "^3.1.1",
+    "remark-rehype": "^11.1.2",
+    "remark-stringify": "^11.0.0",
+    "remark-toc": "^9.0.0",
+    "remark-typography": "^0.6.36",
+    "remark-validate-links": "^13.1.0",
+    "to-vfile": "^8.0.0",
+    "unified-lint-rule": "^3.0.1",
+    "unist-util-visit": "^5.0.0",
+    "vfile-reporter": "^8.1.1"
+  },
+  "scripts": {
+    "lint": "remark . --quiet --frail",
+    "format": "remark . --output --quiet",
+    "format:check": "remark . --quiet",
+    "check-links": "markdown-link-check **/*.{md,mdx,mdd}",
+    "process": "pnpm run format && pnpm run lint",
+    "process:safe": "pnpm run format:check && pnpm run lint",
+    "clean-cache": "rm -rf .remark-cache",
+    "test": "pnpm run process:safe"
+  }
+}

package/setup.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+
+/**
+ * Setup script for markdown processor project
+ * Creates necessary directories and example files
+ */
+
+import fs from 'fs/promises'
+import path from 'path'
+
+const EXAMPLE_FILES = {
+  'content/docs/getting-started.md': `---
+title: Getting Started Guide
+date: 2024-01-15
+author: Team
+---
+
+# Getting Started Guide
+
+This is an example markdown file that will be processed by our formatter.
+
+## Installation
+
+1. Clone the repository
+2. Run \`npm install\`
+3. Start formatting your files
+
+### Prerequisites
+
+Before you begin, make sure you have:
+
+* Node.js 16 or higher
+* npm or yarn package manager
+
+## Usage
+
+The formatter supports various commands:
+
+- \`npm run lint\` - Check for issues
+- \`npm run format\` - Fix formatting  
+- \`npm run process\` - Complete processing
+
+**Note**: Always backup your files before processing.
+
+> **Warning**: Some changes cannot be automatically fixed and require manual review.
+
+For more details, see the [API Reference](./api-reference.md).
+`,
+
+  'content/docs/api-reference.md': `---
+title: API Reference  
+date: 2024-01-20
+---
+
+# API Reference
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| \`bullet\` | string | \`-\` | Unordered list marker |
+| \`emphasis\` | string | \`_\` | Emphasis marker |
+| \`strong\` | string | \`*\` | Strong marker |
+
+## Available Scripts
+
+### npm run lint
+
+Checks all markdown files for style violations.
+
+\`\`\`bash
+npm run lint
+\`\`\`
+
+### npm run format  
+
+Automatically fixes formatting issues.
+
+\`\`\`bash
+npm run format
+\`\`\`
+
+## Custom Rules
+
+You can add custom rules in \`.remarkrc.js\`:
+
+\`\`\`javascript
+['remark-lint-maximum-line-length', 80]
+\`\`\`
+`,
+
+  'content/blog/index.md': `# Blog Posts
+
+Welcome to our blog! Here are our latest posts:
+
+## Recent Posts
+
+- [Markdown Tips and Tricks](./2024-01-15-markdown-tips.md)
+- [MDX Features Overview](./2024-02-01-mdx-features.mdx)
+
+## Archive
+
+Browse all posts by date or category.
+`,
+
+  'content/guides/style-guide.md': `---
+title: Markdown Style Guide
+---
+
+# Markdown Style Guide  
+
+This document defines the formatting standards enforced by this project.
+
+## Headings
+
+- Use ATX-style headings (\`#\` syntax)
+- Don't skip heading levels
+- Add blank lines before and after headings
+
+### Good Example
+
+\`\`\`markdown
+# Main Heading
+
+## Section Heading  
+
+### Subsection Heading
+\`\`\`
+
+### Bad Example  
+
+\`\`\`markdown
+#Main Heading
+####Skipped Levels
+\`\`\`
+
+## Lists
+
+### Unordered Lists
+
+Use hyphens (\`-\`) for unordered lists:
+
+\`\`\`markdown
+- First item
+- Second item
+  - Nested item
+  - Another nested item
+\`\`\`
+
+### Ordered Lists
+
+Use periods (\`.\`) for ordered lists:
+
+\`\`\`markdown
+1. First step
+2. Second step
+3. Third step
+\`\`\`
+
+## Emphasis
+
+- Use \`_underscores_\` for _emphasis_
+- Use \`**asterisks**\` for **strong emphasis**
+
+## Code
+
+### Inline Code
+
+Use \`backticks\` for inline code.
+
+### Code Blocks
+
+Always use fenced code blocks with language identifiers:
+
+\`\`\`javascript
+function example() {
+  return "Hello World"
+}
+\`\`\`
+
+## Links
+
+- Use descriptive link text
+- Include link titles when helpful: [Example](https://example.com "Example Website")
+
+## Images
+
+Always include descriptive alt text:
+
+\`\`\`markdown
+![Screenshot of the main dashboard](./images/dashboard.png)
+\`\`\`
+`
+}
+
+async function createDirectory(dirPath) {
+  try {
+    await fs.mkdir(dirPath, { recursive: true })
+    console.log(`✓ Created directory: ${dirPath}`)
+  } catch (error) {
+    console.error(`✗ Failed to create directory ${dirPath}:`, error.message)
+  }
+}
+
+async function createFile(filePath, content) {
+  try {
+    // Ensure the directory exists
+    const dir = path.dirname(filePath)
+    await createDirectory(dir)
+    
+    // Write the file
+    await fs.writeFile(filePath, content, 'utf8')
+    console.log(`✓ Created file: ${filePath}`)
+  } catch (error) {
+    console.error(`✗ Failed to create file ${filePath}:`, error.message)
+  }
+}
+
+async function setup() {
+  console.log('🚀 Setting up markdown processor project...\n')
+  
+  // Create directories
+  const directories = [
+    'content',
+    'content/docs', 
+    'content/blog',
+    'content/guides'
+  ]
+  
+  console.log('📁 Creating directories...')
+  for (const dir of directories) {
+    await createDirectory(dir)
+  }
+  
+  console.log('\n📝 Creating example files...')
+  for (const [filePath, content] of Object.entries(EXAMPLE_FILES)) {
+    await createFile(filePath, content)
+  }
+  
+  console.log('\n✅ Setup complete!')
+  console.log('\nNext steps:')
+  console.log('1. Run `npm install` to install dependencies')
+  console.log('2. Run `npm run process` to format the example files')  
+  console.log('3. Check the `content/` directory for formatted examples')
+  console.log('4. Add your own markdown files to the `content/` directory')
+  console.log('\nAvailable commands:')
+  console.log('- `npm run lint` - Check for formatting issues')
+  console.log('- `npm run format` - Fix formatting issues')
+  console.log('- `npm run process` - Format and lint files')
+  console.log('- `npm run check-links` - Check for broken links')
+}
+
+// Run setup if this script is executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  setup().catch(console.error)
+}
+
+export { setup }