@webdesigndecal/mark2html
Advanced tools
A quick way to generate basic websites with your markdowns
Your markdowns stay the same. For detailed notes about the markdown syntax (in GitHub flavor), please check showdown.
To generate HTML from a markdown file, run npx @webdesigndecal/mark2html [your markdown file]. (npx is a package runner for Node.js modules. It allows you to run npm command-line utilities like mark2html without installing it globally, and comes with npm. But you can also install mark2html normally, with npm i -g @webdesigndecal/mark2html, and use it by just running mark2html in your command line.)
For example, with instructions.md, we may run either:
npx @webdesigndecal/mark2html instructions.md
# outputs to ./instructions-mark2html-output/
npx @webdesigndecal/mark2html instructions.md ./dist/
# outputs to specified output dir, ./dist/
We can specify the optional output dir as the second command line argument; if there is none specified, it'll default to [your file name]-mark2html-output, as shown above.
Here are some exciting macros to enhance your experience,
{.include relative/path/to/src/file}
The text from another file will be injected in the page. The file will be searched relative to the markdown file or relative to the build-in resources directory.
{.link relative/path/to/src/file}
{.link relative/path/to/src/file | optional-text}
The file will be copied to the output directory & the markdown will be generated [relative/path/to/dist/file](optional-text).
Since the syntax for image embedding is , we can similarly embed the image with the macro,
!{.link relative/path/to/src/image | alt-text}
If wish to only generate the relative/path/to/dist/file, consider using
{.link* relative/path/to/src/file}
If you wish to zip the file after copying to the destination, try adding a :zip suffix,
{.link:zip relative/path/to/src/file | optional-text}
To set a variable,
{.let variable value}
{.let variable}value{./let}
{.let variable}
<!-- Value can span multiple lines -->
{./let}
To inject a variable value
{. variable}
A powerful action is that you may set the value of a variable as a range of markdown text and replay that range of text with injection.
{.raw}
<!-- Some HTML -->
{./raw}
Some of your text will be pruned while it's transformed into HTML. Wrapping your text with {.raw} will preserve its content. When writing some template, you would want to wrap <!doctype>, <head>, <body> with {.raw}.
After cloning the repo, run npm install.
You may find some samples demoing the features under examples/. To generate a website, run bin/cli.js path/to/markdown.md; running bin/cli.js examples/assignment-sample/instructions.md will generate a website placed in the file's directory examples/assignment-sample/instructions-mark2html-output/.
FAQs
A quick way to generate basic websites with your markdowns
We found that @webdesigndecal/mark2html demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Socket researchers discovered nine malicious NuGet packages that use time-delayed payloads to crash applications and corrupt industrial control systems.
Security News
Socket CTO Ahmad Nassri discusses why supply chain attacks now target developer machines and what AI means for the future of enterprise security.
Security News
Learn the essential steps every developer should take to stay secure on npm and reduce exposure to supply chain attacks.