md-cli-converter
Version:
A CLI tool that converts Markdown files into static HTML websites with customizable themes
143 lines (107 loc) • 2.83 kB
Markdown
## md-cli-converter
A simple CLI tool that lets you generate static HTML files from Markdown. Supports custom styles (`.css`) and custom templates (`.ejs`)
## To Start
Install globally from [npm](https://www.npmjs.com/package/md-cli-converter):
``` bash
npm install -g md-cli-converter
```
Default use - convert a Markdown file (.md) into an HTML file:
``` bash
md-to-html notes.md --output site/
```
This will convert `notes.md` to `notes.html` and save the output in the `site/` folder and automatically apply the default `styles.css`
```
site/
│── notes.html
│── styles.css
```
## Custom Styling (`--css`) - You can use your own CSS file instead of the default `styles.css`:
``` bash
md-to-html notes.md --output site/ --css styles/custom.css
```
Example Directory:
```
my-project/
│── notes.md
│── styles/
│ ├── custom.css
│── site/
│ ├── notes.html
│ ├── custom.css // Copied here automatically
```
## Custom Templates (`--template`) - For a custom HTML structure define your own EJS template:
``` bash
md-to-html notes.md --output site/ --template templates/my-template.ejs
```
Example Directory:
```
my-project/
│── notes.md
│── templates/
│ ├── my-template.ejs
│── site/
│ ├── notes.html // Uses my-template.ejs
```
Example Markdown File (`notes.md`)
``` Markdown
title: My First Blog Post
author: First Last
date: 2025-02-10
---
# Welcome to My Blog
This is an example Markdown file that will be converted into HTML
## Features:
- Converts Markdown to HTML
- Supports custom styles
- Works with custom templates
```
Generated HTML (`notes.html`)
``` HTML
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>My First Blog Post</title>
<meta name="author" content="First Last">
<meta name="date" content="2025-02-10">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<header>
<h1>My First Blog Post</h1>
<p>By Jane Doe | 2025-02-10</p>
</header>
<main>
<h1>Welcome to My Blog</h1>
<p>This is an example Markdownfile that will be converted into HTML</p>
<h2>Features:</h2>
<ul>
<li>Converts Markdown to HTML</li>
<li>Supports custon styles</li>
<li>Works with custon templates</li>
</ul>
</main>
<footer>
<p>Generated with <strong>Static Site CLI</strong></p>
</footer>
</body>
</html>
```
## Command Reference
Converts a Markdown file to HTML
``` bash
md-to-html <file>
```
Specifies the output directory
``` bash
--output <dir>
```
Applies a custom CSS file
``` bash
--css <file>
```
Uses a custom EJS template
``` bash
--template <file>
```