This is huge news for everyone who writes documents!
.markdown is not optimal at all, but it's a great start. Why this matters (some selling points):
- A step towards real version control. Since text-based, easy to track documents with git, the system the entire software industry runs on. Diffs, history, branching, and worktrees are more approachable!
- Portability. There are tools which can convert markdown to other formats like .docx and even typst!
- AI-friendly. Easier for the machines/LLMs to understand us (as in llmstxt.org) and for us to talk to them
- Nice and fast visuals. Just ask a machine to make a mermaid.js flowchart
- Light footprint. .markdown/.md and .mermaid/.mmd are very environmentally friendly and sustainable, since text can be compressed very well
See more:
this is huge news for everyone who writes documents!
.markdown is https://www.hendrik-erz.de/post/is-markdown-taking-over https://www.infoworld.com/article/2258847/markdown-vs-alternatives-for-software-documentation.html?utm_source=chatgpt.com https://www.ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/ https://mister-gold.pro/posts/do-not-use-markdown-for-docs/, but it's a great start. Why this matters (some selling points):
- A step towards real version control. Since text-based, easy to track documents
- with https://www.youtube.com/shorts/tWQtuGXHJfQ, the system the https://www.youtube.com/watch?v=2ReR1YJrNOM runs on. https://www.codecademy.com/article/what-is-diffing, https://www.youtube.com/watch?v=hwP7WQkmECE and https://www.youtube.com/shorts/efVKPUr9D1A are more approachable!
- Portability. There are https://www.google.com/search?q=convert+markdown+to+other+format which can convert markdown to other formats like .docx and even https://typst.app/!
- AI-friendly. Easier for the machines/https://developer.webex.com/blog/boosting-ai-performance-the-power-of-llm-friendly-content-in-markdown to understand us (as in https://llmstxt.org/#format) and for us to talk to them
- Nice and fast visuals. Just https://www.youtube.com/watch?v=FvSI68laaDA&t=134s to https://www.youtube.com/watch?v=SgPYIfxk4Ok a mermaid.js https://www.youtube.com/watch?v=u9W5yH8MQkI
- Light footprint. https://en.wikipedia.org/wiki/Markdown and https://mermaid.ai/open-source/ecosystem/integrations-create.html are very https://onlinelibrary.wiley.com/doi/10.1111/jiec.12630 https://www.loc.gov/preservation/digital/formats/ https://rdm.mpdl.mpg.de/before-research/file-formats https://www.google.com/search?q=Sustainable+Authorship+in+Plain+Text+using++and+Markdown, since text can be compressed very well
See more:
https://www.youtube.com/shorts/-aSSrmAXHDg
https://mermaid.ai/open-source/syntax/examples.html
Microsoft