Show HN: Markdown as Web Page/Site

This page summarizes the projects mentioned and recommended in the original post on news.ycombinator.com

Our great sponsors
  • SurveyJS - Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • WorkOS - The modern identity platform for B2B SaaS
  • casual-markdown-page

    Markdown as Web Page/Site

  • Docusaurus

    Easy to maintain open source documentation websites.

    I was under the same impression as well. I have been using https://docusaurus.io/ for some time now and I am very happy with it and I am pretty sure there are other tools out there as well.

  • SurveyJS

    Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App. With SurveyJS form UI libraries, you can build and style forms in a fully-integrated drag & drop form builder, render them in your JS app, and store form submission data in any backend, inc. PHP, ASP.NET Core, and Node.js.

  • orgmode

    Orgmode clone written in Lua for Neovim 0.9+.

    There's actually a quite featureful version of org for Neovim: nvim-orgmode https://github.com/nvim-orgmode/orgmode

  • MkDocs

    Project documentation with Markdown.

  • md-page

    📝 create a webpage with just markdown

    I use this one which is also nice: https://github.com/oscarmorrison/md-page

  • Grav

    Modern, Crazy Fast, Ridiculously Easy and Amazingly Powerful Flat-File CMS powered by PHP, Markdown, Twig, and Symfony

    The Grav CMS also internally uses Markdown for the page contents and generates static files: https://getgrav.org/

    They do use YAML FrontMatter for attaching metadata so the CMS knows how to process certain pages (e.g. page title, page type etc.), but it isn't too complicated in practice: https://learn.getgrav.org/17/content/content-pages#page-file

    They also have an admin plugin, which you can use if you prefer a more traditional workflow, even if it just generates the same file format under the hood: https://learn.getgrav.org/16/admin-panel/introduction

    I'm actually using an ancient version of Grav for my own blog, although I had to put the admin path behind additional auth (in addition to the one it already provides), for safety: https://blog.kronis.dev/

    I really like hybrid systems like that: a CMS for blogging or just writing in general that's based on Markdown, generates static files for decent performance, but is also extensible with additional functionality, and also has a decent web UI if you want one.

    (there are probably other CMSes like that out there, or more generic solutions, too)

  • casual-markdown

    A very lightweight regexp-based markdown parser, with TOC and scrollspy support

  • InfluxDB

    Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

  • docsify

    🃏 A magical documentation site generator.

  • markdown-blog

    Simple PHP blog that renders markdown posts. No installation or database needed.

    I did something similar, but for adding a blog system to a server running PHP: https://github.com/Cristy94/markdown-blog

    The idea is that having it server-side allows for the page to be cached by a CDN (e.g. CloudFlare), so you end up serving static HTML, with better performance and SEO than JS-compiled markdown.

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts