The Evolution of Technical Writing: From Early Computer Manuals to Modern Markdown Editors like Yuque

Why Developers Like Markdown?

Most developer tools today support Markdown, including GitHub, Gitee, Trello, and Slack, and many developers use Markdown‑enabled editors to build personal blogs.

In the early 2000s, platforms like WordPress and TypePad offered limited editing capabilities, forcing developers to write in raw HTML; John Gruber, a UI designer, grew frustrated with this and sought a simpler solution.

Inspired by the aesthetics of plain‑text email, Gruber, with help from Reddit co‑founder Aaron Swartz, released the first version of Markdown on March 19, 2004.

Markdown is lightweight compared to HTML, supporting headings, bold, italics, blockquotes, code blocks, images, and links, allowing developers to write and format using only the keyboard.

Its simple syntax is easily parsed by browsers, making it suitable for a wide range of web scenarios, which explains its widespread adoption in README files, online documentation, and personal blogs.

Yuque: A Markdown‑Based Knowledge Platform

Beyond self‑hosted blogs, many Chinese developers now prefer Markdown‑compatible platforms such as Notion, Yuque, Shimo Docs, and Evernote for documentation and knowledge bases.

Yuque, incubated within Ant Group, quickly gained popularity; its most used features are image cards (71 million uses) and code blocks (25 million uses).

Yuque originated in 2016 when an Ant Financial Cloud engineer built a lightweight documentation tool using React, Ant Design, and CodeMirror for the markdown editor.

In 2017, Yuque expanded from a team‑only tool to a company‑wide knowledge platform, adding a rich‑text editor with formulas, diagrams, and mind maps.

The editor later migrated from CodeMirror to Slate, and the team forked Slate to add a custom content storage format for better performance and compatibility.

Facing increasing complexity, Yuque eventually built its own editor using Contenteditable for rich text, Canvas for tables, and SVG for mind maps, and moved the entire backend to the cloud with a full‑stack JavaScript stack.

Features Developers Appreciate in Yuque

Yuque’s code block feature has evolved from simple markdown rendering to support nearly a hundred languages, with naming, theme switching, height adjustment, and function folding.

The drawing board combines text drawing, mind maps, and flowcharts, enabling rapid creation of technical architecture diagrams.

Open APIs allow developers to sync Yuque blogs to personal GitHub repositories.

Additional developer‑friendly elements include full‑keyboard editing, knowledge‑base navigation, and a “creation index” wall.

The team plans to open‑source the Yuque editor code, inviting community collaboration to further improve the product.

Conclusion

Writing is a valuable habit for developers, helping lifelong learning, and a good documentation tool like Yuque can turn personal knowledge into a lasting, reusable knowledge base.