···11# morkdeck
2233morkdeck is a dead-simple slideshow generator for
44-[Markdoc](https://markdoc.dev/) files. Its guiding concepts are:
44+[Markdoc](https://markdoc.dev/) files. Its guiding objectives are:
5566-- Minimizing time-to-presentation so you get your freaking slides done
66+- Minimizing time-to-presentation so you get your frickin' slides done
77- Opinionated styling and layout with easy outs, so you can focus on your
88 content
99- Your Markdoc is the source of truth; no codebase (node_modules, src directory,
···1313[Markdoc](https://markdoc.dev/), and
1414[mdx-deck](https://github.com/jxnblk/mdx-deck) (my beloved).
15151616+## Supported features
1717+1818+- Single-file HTML output
1919+- Dev-server with live reload while you're editing your slides
2020+- Pretty code blocks using [Shiki](https://shiki.style)
2121+- [Mermaid diagram](https://mermaid.js.org/intro/) support with `mermaid` code fences
2222+1623## Usage
17241818-Still a work in progress.
2525+Still a work in progress, so we're failing objective #3.
19262020-If you really want to give it a try, you can clone the repo and point
2121-`main.ts dev` at a Markdoc file of your choice:
2727+If you want to give morkdeck a try, you can clone this repo and use the `deno task` commands.
22282329```sh
2424-deno run --unstable-broadcast-channel -A main.ts dev ./slides.mdoc
2525-```
3030+# Start a dev server at port 8000
3131+deno task dev my-slides.mdoc
26322727-You'll be able to access your presentation at port 8000. Static builds aren't
2828-implemented yet.
3333+# Output a .html file in `./dist`
3434+deno task build my-slides.mdoc
3535+```