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)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

AWS GenAI LIVE!

GenAI LIVE! is a dynamic live-streamed show exploring how AWS and our partners are helping organizations unlock real value with generative AI.

Tune in to the full event

DEV is partnering to bring live events to the community. Join us or dismiss this billboard if you're not interested. ❤️