{"repo":"dbohdan/caddy-markdown-site","free":true,"listed":false,"github":"https://github.com/dbohdan/caddy-markdown-site","clone":"git clone https://github.com/dbohdan/caddy-markdown-site.git","description":"Serve Markdown files as HTML pages with CSS using just Caddy","language":"CSS","stars":68,"topics":["caddy","caddyserver","markdown"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"caddy-markdown-site This project is a proof of concept showing how you can serve Markdown files as reasonably good-looking minimal web pages with just the Caddy web server. It is not a static site generator; there is no build step. The project consists of a Caddy configuration file (Caddyfile), HTML templates, and CSS files. You will need some knowledge of Caddy to use and customize the project. Expect a lot of work, and possibly insurmountable barriers, if you decide to adapt it for anything but a simple website. Screenshot Requirements - Caddy 2.4 or later. - Optional: - Deno 1.31 or later to run the tests ( just test ). - entr for development ( just dev ). - just to run the tasks. Features - If your page file is demo/foo.md and your domain example.com, you will be able to access the file as example.com/foo with no extension and example.com/foo.md. - index.md serves as the directory index (but index.html takes priority). - You can customize the look of your site without touching the main template. Edit templates/{head,header,footer}.html to do it. head.html links to the style sheets. - An error page is shown on error. Front matter Markdown page files can include Caddy template front matter in JSON, TOML, or YAML. The front matter sets variables that configure how a page is presented. The following variables are recognized: - lang : the lang HTML global attribute. If not specified, defaults to an empty string. - text dir : the dir HTML global attribute. Defaults to auto . - ","default_branch":null,"files":null,"tree":[],"storefront":"/r/dbohdan","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/dbohdan/caddy-markdown-site/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}