Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
Bending Markdown
to Your Will With Your
Static Site Generator
Leon Barnard, Balsamiq
Anyone Else Have This Problem?
The Customer's Problem
What We Wanted
The Problems with Markdown
The Dilemma
How do we write content that can
show up in multiple places?
The Solution
* Hidden from search and other links
Limitations
• Can't include partial content. All or nothing (except front
matter).
• Requires duplicate empty "placeholder...
Wins
• Provides a flexible framework for future product versions
• Allows us to continue to write only (mostly) markdown fo...
Thanks!
Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator
Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator
Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator
Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator
Upcoming SlideShare
Loading in …5
×

Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator

194 views

Published on

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.

Published in: Technology
  • Be the first to comment

Lightning Talk: Bending Markdown to Your Will with Your Static Site Generator

  1. 1. Bending Markdown to Your Will With Your Static Site Generator Leon Barnard, Balsamiq
  2. 2. Anyone Else Have This Problem?
  3. 3. The Customer's Problem
  4. 4. What We Wanted
  5. 5. The Problems with Markdown
  6. 6. The Dilemma How do we write content that can show up in multiple places?
  7. 7. The Solution * Hidden from search and other links
  8. 8. 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
  9. 9. 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)
  10. 10. Thanks!

×