Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator
Feb. 7, 2017•0 likes
1 likes
Be the first to like this
Show More
•376 views
views
Total views
0
On Slideshare
0
From embeds
0
Number of embeds
0
Download to read offline
Report
Technology
A short story about how (Balsamiq) we were able to include content from one markdown file inside another by using the features of our Static Site Generator, Hugo. Prepared as a lightning talk for a Write The Docs SF meetup.
Limitations
• Can't include partial content. All or nothing (except front
matter).
• Requires duplicate empty "placeholder" files to insert
content into.
• Standard issues with "single source" models (see, e.g.,
http://idratherbewriting.com/2016/02/11/the-problem-with-
single-source-publishing/)
• Working around some of these though
Wins
• Provides a flexible framework for future product versions
• Allows us to continue to write only (mostly) markdown for
the content (no code needed for includes)