DEV Community

Omar Hussein
Omar Hussein

Posted on

1

TILvert, my first open-source project

Today I released the very first version of my open-source text conversion utility. This utility was designed to quickly generate blog posts using your filesystem.

Tilvert is a simple tool to convert TILs from markdown files to HTML

Installation

$ npm install -g https://github.com/omalk98/TILvert.git
Enter fullscreen mode Exit fullscreen mode

Uninstall

$ npm uninstall -g tilvert
Enter fullscreen mode Exit fullscreen mode

Usage

$ tilvert [flags/options] <path>
Enter fullscreen mode Exit fullscreen mode

If no path is specified, TILvert will read the current directory recursively to find all files with the matching extension (default "txt").

Flags

Flag Description
-h, --help Displays help information.
-v, --version Displays version information.

Options

Option Description
-e, --extension Extension for the files in the input directory. (Ignored if input is file). Default (txt).
-o, --output Path to the output directory. Default (./til).
-s, --stylesheet Path to the stylesheet.
--title Title of the HTML page.
--author Author of the HTML page.
--description Description of the HTML page.
--keywords Keywords of the HTML page.
--robots Robots of the HTML page.
--generator Generator of the HTML page.
--theme-color Theme color of the HTML page.

License

TILvert is licensed under the MIT License

Features

  • [x] Convert markdown files to HTML
  • [x] Replicate directory structure in output directory
  • [x] Customizable HTML page with meta tags
  • [x] Customizable stylesheet
  • [x] Customizable extension for input files
  • [x] Customizable output directory

Top comments (0)

👋 Kindness is contagious

Dive into an ocean of knowledge with this thought-provoking post, revered deeply within the supportive DEV Community. Developers of all levels are welcome to join and enhance our collective intelligence.

Saying a simple "thank you" can brighten someone's day. Share your gratitude in the comments below!

On DEV, sharing ideas eases our path and fortifies our community connections. Found this helpful? Sending a quick thanks to the author can be profoundly valued.

Okay