{"id":15285329,"url":"https://github.com/minkjs/mink","last_synced_at":"2026-02-15T16:04:00.009Z","repository":{"id":41821052,"uuid":"97152173","full_name":"minkjs/mink","owner":"minkjs","description":"Live Markdown server and static-site generator.","archived":false,"fork":false,"pushed_at":"2025-06-05T22:06:28.000Z","size":1604,"stargazers_count":0,"open_issues_count":55,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-14T08:58:23.205Z","etag":null,"topics":["handlebars","includes","markdown","server","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/minkjs.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-07-13T18:12:33.000Z","updated_at":"2020-07-30T12:43:37.000Z","dependencies_parsed_at":"2025-10-04T05:09:14.600Z","dependency_job_id":null,"html_url":"https://github.com/minkjs/mink","commit_stats":null,"previous_names":["f1lt3r/mink"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/minkjs/mink","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minkjs%2Fmink","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minkjs%2Fmink/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minkjs%2Fmink/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minkjs%2Fmink/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/minkjs","download_url":"https://codeload.github.com/minkjs/mink/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minkjs%2Fmink/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29483323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T15:33:17.885Z","status":"ssl_error","status_checked_at":"2026-02-15T15:32:53.698Z","response_time":118,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["handlebars","includes","markdown","server","static-site-generator"],"created_at":"2024-09-30T15:04:13.715Z","updated_at":"2026-02-15T16:03:59.993Z","avatar_url":"https://github.com/minkjs.png","language":"JavaScript","readme":"# Mink\n\n\u003e Remix your Markdown with this live Markdown server and static-site generator\n\n[![Build Status](https://travis-ci.com/minkjs/mink.svg?token=qoHuwCLMzrVokCyqzWgj\u0026branch=master)](https://travis-ci.com/minkjs/mink)\n[![Coverage Status](https://coveralls.io/repos/github/minkjs/mink/badge.svg?branch=master\u0026t=Z79OeA)](https://coveralls.io/github/minkjs/mink?branch=master)\n[![Npm Version](https://img.shields.io/npm/v/mink.svg)](https://www.npmjs.com/package/mink)\n[![Github Issues](https://img.shields.io/github/issues/minkjs/mink.svg)](https://github.com/minkjs/mink/issues)\n[![Known Vulnerabilities](https://snyk.io/test/github/minkjs/mink/badge.svg)](https://snyk.io/test/github/minkjs/mink)\n[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo)\n\n## About Mink\n\nUse cases\n\n- Web Server with live Markdown preview\n- Static-site generator\n- Software documentation tool\n- Website generator\n\n## How Mink Works\n\nMink launches an HTTP server from a local directory.\n\n```shell\ncd ~/repos/my-site\nmink\n```\n\n\n- Mink renders your Markdown files as HTTP on the fly.\n- Mink watches your files for changes, and re-renders them to all of your devices simultaneously.\n- Mink exports your project to static files that can be uploaded to a server.\n\n### Mixed-Mode Markdown\n\nMink uses Mixed-Mode Markdown, combining Handlebars templates with Markdown syntax.\n\n```html\n{{#each article}}\n\u003carticle\u003e\n    \u003ch2\u003e{{article.title}}\u003c/h2\u003e\n\u003c/article\u003e\n{{/each}}\n```\n\n### Include Syntax\n\nMink adds includes syntax to your HTML and Markdown files.\n\n```\n\u003c!-- File: index.html --\u003e\n\u003chead\u003e\n\t\u003c!-- mink: styles.less --\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n\t\u003c!-- mink: home-page.md --\u003e\n\u003c/body\u003e\n```\n\n### Re-Usable Project Configuration\n\nMink lets your configure your projects with `Minkconf.js`.\n\n```javascript\n// File: Minkconf.js\n\nconst Minkconf = {\n\tplugins: {\n\t\tmarkdown: {\n\t\t\tpath: '**/*.md'\n\t\t\thandler: 'mink-markdown'\n\t\t}\n\t},\n\twatch: {\n\t\t'**/*.md'\n\t},\n\texport: {\n\t\t'**/*.md'\n\t}\n}\n\nmodule.exports = Minkconf\n```\n\n### Custom Handlers\n\nMink lets you rapidly build custom handlers for http routes.\n\n```javascript\n// File: Minkconf.js\n\nconst typescript = require('typescript')\n\nconst Minkconf = {\n\tplugins: {\n\t\ttypescript: {\n\t\t\tpath: '**/*.ts'\n\t\t\thandler: $file =\u003e ts.transpileModule($file.contents).outputText\n\t\t}\n\t}\n}\n\nmodule.exports = Minkconf\n```\n\n\n\n## Why Mink Exists\n\n1. Software Documentation\n1. Blog and Static-Site Creation\n1. Pull-Mode Task Runner\n\nMink is a powerful command-line tool used to produce written content for the web. Mink is designed from the ground up for technical writting, blogging and software documentation. Mink lets you slice, dice and remix structured Markdown content in realtime. Mink serves your content while you create, then exports your flattened project as part of your build pipeline.\n\n\n\n## Getting Started\n\nInstallation:\n\n```shell\nyarn --global add mink\n```\n\nLaunch server from the current directory:\n\n```shell\nmink\n```\n\n\n\n## Features\n\n- Simple project configuration file (Markconf.js)\n- Mink Server\n\t+ Serves local directories as content\n\t+ Markdown files are converted to HTML\n\t+ Auto-reload on file changes\n- Splice structrued content together, Eg:\n\t+ HTML inside HTML with: `\u003c!-- mink | path/to/foo.html --\u003e`\n\t+ Markdown inside Markdown with: `\u003c!-- mink | path/to/bar.md --\u003e`\n\t+ Fetch external content:  `\u003c!-- mink | https://en.wikipedia.org/wiki/Cat --\u003e`\n\t+ Get the first 100 Fibonacci numbers from a plugin:  `\u003c!-- mink | fibonacci | {n: 100} --\u003e`\n- Plugins\n\t+ Write local project modules with simple plugin architecture\n\t+ Publish your module to the NPM Registry\n\t+ Add your module to your `package.json` file\n\t+ Plugins can have their own Handlebars HTML templates\n\t+ Plugins can return a `{body}` object to be rendered to a template\n\t+ Pluings can also override and send the HTTP response themselves\n- Export\n\t+ Export the entire content as HTML to be uploaded\n\t+ Export directory structure alongside binary files like images\n\t+ Export to PDF\n\n## Installation\n\nMink serves Markdown content from anywhere in your filesystem. You can install Mink globally.\n\n```shell\nyarn global add mink\n```\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminkjs%2Fmink","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminkjs%2Fmink","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminkjs%2Fmink/lists"}