Docmach - Markdown Compiler for Blogs & Project Documentation

Docmach is a Markdown-powered static site generator designed for modern blogs and project documentation. It integrates the simplicity of Markdown and Tailwind CSS to generate sites with minimal effort.

Why Choose Docmach

Markdown-First – Write Markdown, and let Docmach handle the rest
Tailwind CSS Integration – Built-in Tailwind CSS compiler for beautiful, responsive designs
Ultra-Fast Builds – Optimized for speed and performance
Custom Themes – Choose from available themes or create your own
Live Reload & Watch Mode – Instant preview while editing your content

Get Started

# Install globally
npm i -g docmach

# Create a new project
mkdir my-blog
cd my-blog
docmach

Programmatic Usage

Docmach can be used as a library for dynamic content generation:

import Docmach from "docmach";

// Compile a specific file
await Docmach("docs/my-post.md");

Use Cases:

Dynamic blog engines - Generate posts on-demand
CMS integration - Compile content from external sources
API-driven documentation - Build docs from API responses
Automated workflows - Integrate with CI/CD pipelines

Example workflow:

User creates content via API
Save to S3 or local storage
Call Docmach(file) to compile
Serve generated HTML with Nginx or CDN

How Docmach Works

Docmach parses all .md files in your input folder, extracting and processing Markdown and HTML content. It uses special Docmach tag to apply templates and functions.

Docmach Tag

Docmach tags work similarly to HTML tags:

<docmach
  type="fragment"
  file="template.html"
  params="title=My Page; author=JohnDoe"
/>

<!-- Function parameters example -->
<docmach
  type="function"
  file="author-bio.js"
  params="title=My Page; author={name: JohnDoe, age: 24, date: 20th March 2015}"
/>

Using Fragment Templates

Fragment templates allow you to create reusable HTML components:

<!-- template.html -->
<html>
  <head>
    <title>{{ title }}</title>
  </head>
  <body>
    <h2>{{ author }}</h2>
  </body>
</html>

Using Function Templates

Function templates enable dynamic content generation:

// in author-bio.js
export default function (title, author) {
  return `
   <div>
   <h1>by ${title}</h1>
   <h3>by ${author.name}</h3>
   <p>Aged: ${author.age}</p>
   <p>On: ${author.date}</p>
   </div>
   `;
}

Configuration

Add the following to your package.json file:

"docmach": {
  "docs-directory": "./docs",
  "build-directory": "./docmach",
  "assets-folder": "./assets"
}

About Docmach

Markdown-Powered, But Smarter – Understands context and allows nested Markdown inside HTML elements
Tailwind, But on Your Terms – Not forced into Tailwind, but intelligently processes styles if enabled
Live Reload That Actually Works – Watch mode ensures smooth development experience even with large projects
Optimized Typography – Applies optimized typography settings for professional and polished content
Intelligent Asset Handling – Automatically copies, optimizes, and references assets
Code Highlighting – Uses highlight.js with custom themes for readable code snippets
CLI That Doesn’t Get in Your Way – Zero-config mode by default with options for power users
Fast, Even at Scale – Batch processes file changes to avoid unnecessary rebuilds
SEO & Accessibility Built-In – Generates clean, semantic HTML optimized for search engines

Designed to be focused on speed, developer experience, and flexibility.