Reasons:

• Easier to modify than Ruby-based step files
• Easier to be hosted as a static-websites (gh-pages, S3, CloudFront etc.)
  • Remove backend server requirement. Currently we're hosting on Heroku and is slow from Taiwan.

Challenges:

• An easy way to insert StepFile widgets (e.g. step / important / tips) within Markdown
• Make cross-page (step) links
  • Maybe borrow wiki-linking parser from GitHub Wiki?
  • Maybe hack Markdown parser?
  • Maybe HTML Pipeline?
• Back link
  • Maybe passing #back=previous_page to the referenced URL and render the link via JavaScript?
• ?

Frameworks:

• GitBook http://www.gitbook.io/

Note: Use English in this issue only. 請用英文討論。