Building Pattern Libraries With Shadow DOM In Markdown

88OP-building-pattern-libraries-with-shadow-dom-in-mark.png
Some people hate writing documentation, and others just hate writing. I happen to love writing; otherwise, you wouldnt be reading this. It helps that I love writing because, as a design consultant offering professional guidance, writing is a big part of what I do. But I hate, hate, hate word processors. My typical workflow using a desktop word processor goes something like this: When writing technical web documentation (read: pattern libraries1), word processors are not just disobedient, but inappropriate. Ideally, I want a mode of writing that allows me to include the components Im documenting inline, and this isnt possible unless the documentation itself is made of HTML, CSS, and JavaScript. In this article, Ill be sharing a method for easily including code demos in Markdown, with the help of shortcodes and shadow DOM encapsulation.

Read Full Article at https://www.smashingmagazine.com/2017/07/pattern-libraries-in-markdown/

Share on FacebookShare on Google+Tweet about this on TwitterShare on LinkedIn

Tags: , , , , , , , , , , , , , , , ,