And that, in turn, led me to tufte-markdown, which is how we got into this mess.Ī few specific formats are supported, with different results: markers in a paragraph are paired with : Footnote text below the paragraph in which they appear they get numbered automatically. That in turn led to Gwern Branwen’s impressive evaluation of damn near every sidenote implementation on the web. If “establishing a consistent domain vocabulary and grammar to streamline design system iteration for complex high-variance content” sounds thrilling to you, hire us., Karen McGrane pointed Ethan Marcotte and I to an excellent post by Koos Looijesteijn outlining his approach to sidenotes. Weren’t actually part of the original markdown spec, but they’ve become a popular bolt-on.ĭuring a heated yak-shaving conversation about enhancements to our site ⊕ Karen and Ethan are my partners in crime at Autogram, a freshly-minted strategic consultancy for companies with complicated content needs. In his books, Tufte instead uses sidenotes, which keep the asides as close as possible to the related text without breaking the flow. Markdown footnotes Footnotes are a convenient way to move digressions and asides out of the primary flow of a document, but shoving them to the bottom of a long page is no good, either. The official Tufte-CSS site explains the more advanced features in detail, but we’re trying to poke and prod things a bit to eliminate some of the manual HTML entry that’s still necessary. In addition to basic markdown features like emphasis, strong text, links, and inline code, the tufte-markdown parser pays special attention to figures and footnotes. Just in case you needed a few extra markdown patterns to remember.
0 Comments
Leave a Reply. |
Details
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |