2024.7.30-95849 • Published 11 months ago

mkmdls v2024.7.30-95849

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
11 months ago

mkmdls (Make Markdown Listing)

Description

mkmdls is a command-line utility that generates markdown files from specified file globs. It helps you create organized markdown documentation by listing the content of your files and providing a directory tree view.

Features

  • Generate markdown files from specified file patterns.
  • Include file content and directory tree in the markdown.
  • Option to include or exclude files using glob patterns.
  • Configurable output file location and naming.
  • Verbose and silent logging options.

Installation

To install the package, you can use npm:

npm install -g mkmdls

Usage

NPX

If you prefer not to install the package globally, you can use npx to run it:

npx mkmdls [options]

Basic Usage

To generate a markdown file listing the content of files matching the provided globs:

mkmdls -i "src/**/*.ts" -o "listing.md" -d "./"

Options

  • -i, --input <globs...>: A list of globs of files to find.
  • -o, --output <file>: The output markdown file. Default: output.md.
  • -d, --directory <dir>: The target directory for input and output. Default: ..
  • -f, --force: Ignore if the output file already exists.
  • -t, --title <title>: The title of the markdown file. Default: File Listing.
  • -c, --config <boolean>: Include the config in the generated markdown. Default: true.
  • -l, --listing <boolean>: Include the file tree listing in the generated markdown. Default: true.
  • -x, --exclude <globs...>: A list of globs to ignore. Default: ["node_modules/**", "dist/**", "build/**"].
  • -s, --silent: Run in silent mode with minimal output.
  • -v, --verbose: Run in verbose mode with detailed output.

Examples

Generating a Markdown Listing with File Tree

mkmdls -i "src/**/*.ts" -o "output.md" -t "Source Files"

Excluding Certain Files

mkmdls -i "src/**/*.ts" -o "output.md" -x "src/test/**"

Overwriting an Existing Output File

mkmdls -i "src/**/*.ts" -o "output.md" -f

Running in Silent Mode

mkmdls -i "src/**/*.ts" -o "output.md" -s

Running in Verbose Mode

mkmdls -i "src/**/*.ts" -o "output.md" -v

NPM Package

The package is available on npm.

Repository

For more information, visit the GitHub repository.

2024.7.30-95849

11 months ago

2024.7.22-193007

12 months ago

2024.7.22-190046

12 months ago

2024.7.22-181219

12 months ago

2024.7.22-180803

12 months ago

2024.7.22-175826

12 months ago

2024.7.22-173825

12 months ago

2024.7.22-173427

12 months ago

2024.29.22-172906

12 months ago

2024.7.22-172230

12 months ago

2024.7.22-171952

12 months ago

2024.7.22-170558

12 months ago

2024.7.22-170321

12 months ago

2024.7.22-165829

12 months ago

2024.7.22-165700

12 months ago

2024.7.22-164809

12 months ago

2024.7.22-163137

12 months ago

2024.7.22-162309

12 months ago

2024.7.22-161804

12 months ago

2024.7.22-161426

12 months ago

2024.7.22-161119

12 months ago

2024.7.22-155950

12 months ago

1.0.0

12 months ago