7 ms·
I was under the impression that using markdown to create html webpages was a common use case, and had been solved. Was I wrong? (I've used markdown for note ta
by reactspa 4y ago
I was under the impression that using markdown to create html webpages was a common use case, and had been solved. Was I wrong?
(I've used markdown for note taking, not for web pages, hence am asking.)
- damethos 4y agoI was under the same impression as well. I have been using https://docusaurus.io/ 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.
- number6 4y agoI am hesitant to give it a try. Mostly use sphinx and .rst - docusaurus looks nice but also overengineered. Is it a lot to set up or is it just markdown all the way and works out of the box?
- damethos 4y agoIt only takes a few minutes to set it up. I use it for my blog, very happy with it.
- casualwriter 4y agoglad to know that.
- number6 4y agoIt really looks great. I like your book section - I wonder why we read the same books. HN recommendations maybe; will look into the ones I didn't read. Thanks for sharing
- zmmmmm 4y agoreminds me of Znai [1] What sold me on Znai was the integration of code snippets (straight from source files, mining them out of the code) and integration of diagramming from PlantUML, which is done in a way that is compatible with the format used in Gitlab, VSCode and other markdown renderers. Markdown has turned into a truly amazing ecosystem. [1] https://testingisdocumenting.org/znai/introduction/what-is-this https://testingisdocumenting.org/znai/introduction/what-is-t...
- ghayes 4y agoCurious if we've ever considered adding Markdown as a new MIME type that could be accepted directly by browsers (similar to text/plain). It could be nice to serve markdown without needing to even use a static-site generator (but still have the server reasonably render the doc, similar to a reader view).
- cxr 4y agoBeaker Browser did this. The first problem about Markdown is: which variant do you support? The second problem is that people already treat it like a markup language with a mandatory post-processing step and will inevitably desire the level of control/precision that can only be achieved by making it more like HTML (or making liberal use of the <html> escape hatch).
- casualwriter 4y agogood point. markdown as web content is widely used, but not whole web page. the project is a sample to use markdown as whole page by putting web element (header,ment,theme) in frontmater.
- altilunium 4y agoAs far as i know [1] https://www.mkdocs.org https://www.mkdocs.org : Markdown to static web page converter [2] https://rentry.co https://rentry.co : Markdown pastebin [3] https://prose.sh https://prose.sh : Markdown blog, upload post via ssh [4] https://bearblog.dev https://bearblog.dev : Markdown blog, upload post via web-browser
- RajT88 4y agoThere's just a ton of libraries around it. I've used Markdowndeep in C#. I forget all the ones I tried (at least 3) before I settled on that one. A colleague just mentioned this to me a few days ago: https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/convertfrom-markdown?view=powershell-7.2&viewFallbackFrom=powershell-5.1 https://docs.microsoft.com/en-us/powershell/module/microsoft...
- wodenokoto 4y agoThe usual approach is to compile markdown to html either before uploading to server or server side. My understanding is this renders markdown to html client side using JavaScript