krivoox / draw-folder-structure

MIT License
13 stars 2 forks source link

Markdown Folder Structure for VS Code

Extension Banner or Logo

A Visual Studio Code extension designed to visually represent your project's folder and file structure in Markdown format. Ideal for documentation and overview purposes, this tool simplifies the process of sharing and understanding project structures. This extension works with vscode version 1.81.0 or higher

Key Features

Usage

  1. Navigate to the file explorer in VS Code.
  2. Right-click on a folder or file.
  3. Select "Generate Markdown structure" from the context menu.
  4. Enjoy your folder structure in Markdown format!

Screenshots

Basic Usage

Click on the option "Generate Markdown structure".

Another Feature

A file with the drawing of the structure will be generated.

Customization

You can customize which folders and files to exclude in the drawing, as well as choose from many markdown layouts.

Exclude folders or files as you like

For example: "node_modules" (Excluded by default). Just add in your settings.json file the line "draw.folder.structure.exclude" and it will show you the default excluded folders and files. You can modify it to your liking using glob patterns!

Examples of exclusion patterns:

Try to create your own pattern!

Custom Setting

Choose the design you like best

Choose from a lot of predefined designs we have to offer. By default we use "EmojiDashes".

List of styles:

Custom Setting

Installation and Usage

  1. Install the extension via Visual Studio Code Marketplace.
  2. Right-click on the desired folder in your VS Code file explorer.
  3. Select 'Generate Markdown Structure' from the context menu.
  4. The Markdown representation of the folder structure is automatically copied to your clipboard.
  5. Paste it into your Markdown file or documentation as needed.

Support and Contribution

For support queries or to contribute to this project, please visit our GitHub repository or contact us at jm.krivocapich@gmail.com.

Contributions

Contributions are welcome. If you encounter any problems or have any suggestions, please open an issue in the GitHub repository. We also invite you to read How to contribute

Made by

Krivoox Follow me on X My linkedin

License

MIT