salauddinn/md-present

md-present is a small command line tool that turns a Markdown file into a single, polished HTML page. The idea is that you can share a plan, some documentation, or a report with people who do not have a Markdown viewer, and they will still see something that looks good. You run it with one command, npx md-present, pointed at your Markdown file, and it writes out an HTML file next to it. There is no configuration needed to get a working result. The generated page automatically switches between light and dark mode based on the reader's system settings, and it includes syntax highlighting for code blocks, support for task lists, and nicely styled tables. A few extra options are built in. You can add a flag to embed local images directly into the HTML file as encoded data, so the whole page is one self-contained file with nothing missing if you move it elsewhere. There is also a flag to open the result straight in your browser, a way to choose a custom output file location, and a local preview server option that re-renders the page each time you refresh, which is handy while you are still editing the Markdown. Under the hood the CSS and any syntax highlighting styles are inlined into the output file, so the HTML is fully standalone and does not depend on any external files to display correctly. The project notes that its rendering logic is kept separate from the command line interface, with an eye toward reusing it later inside a code editor extension. Typical uses include sharing a project plan with non-technical teammates, converting documentation into a single file suitable for email or a basic static host, or generating a clean preview of Markdown content before publishing it somewhere else.