26 votes

The woes of writing markdown

9 comments

  1. [7]
    gryfft
    Link
    The Woes of Writing Markdown (And the wishes of SquiggleMark) is an essay about some of the technical and artistic challenges inherent to writing ergodic text using markup language. I posted her...

    The Woes of Writing Markdown (And the wishes of SquiggleMark) is an essay about some of the technical and artistic challenges inherent to writing ergodic text using markup language. I posted her story Weave Me Another Cocoon last year, and it's a fantastic example of how art can push the limits of a medium and the machinery that supports it.

    But the real superpower of pandoc is that, much in the way switching to neocities escapes the prison‍-roads of locked down platforms, switching to pandoc escapes at once the restrictions of both rich text and standard markdown.

    ...

    Even writing raw HTML isn’t as powerful as what pandoc lets you do, because pandoc has a convenient interface for reading and writing the AST that it translates all its inputs and outputs to.

    ...

    If you aren’t familiar with my work, then when I said I loved the details disclosure element, or that I’m experimental writer doing creative things, you could have brushed it off as a cute yet idle exclamation or an otherwise meaningless remark. If you aren’t familiar, then gaze upon Weave Me Another Cocoon and let its depths ensnare you.

    ...

    And that, finally, is what this year started me down the road to writing my own markdown parser.

    Snuggle Squiggle's website is a work of art in its own right too.

    7 votes
    1. [2]
      post_below
      Link Parent
      Are you friends? If so, pass on that the site loads zoomed in with horizontal scrolling on (at least) the two most popular android mobile browsers. In a similar vein, zooming out to get rid of the...

      Are you friends? If so, pass on that the site loads zoomed in with horizontal scrolling on (at least) the two most popular android mobile browsers. In a similar vein, zooming out to get rid of the side scrolling makes many clickable elements significantly smaller than the fat fingers mobile minimum.

      Site rendering on mobile is worth considering when you're writing about web building!

      That aside, cheers for the IndieWeb link.

      8 votes
      1. gryfft
        Link Parent
        Thanks for reporting that! She's updated to fix that issue and said it was ok if I pass along her explanation of what happened with the CSS -

        Thanks for reporting that! She's updated to fix that issue and said it was ok if I pass along her explanation of what happened with the CSS -

        a few weeks ago i added display: grid to the body, which interacted very strangely with the code blocks on this post, causing the article body to display several screen widths to the right of the initial viewpoint. i only saw this when proofreading the post on the day of its publication. adding an overly hasty width: 40em to main seemed to mostly fix this. this is what causes the scrolling regression on mobile.
        removing display: grid fixes both errors. with a bit more tinkering, i can mostly achieve what it was meant to accomplish with display: flex + a few more rules

        5 votes
    2. [4]
      lou
      Link Parent
      Sorry but what is "ergodic text" in that context?

      ergodic text

      Sorry but what is "ergodic text" in that context?

      3 votes
      1. [3]
        gryfft
        (edited )
        Link Parent
        The common example back in my day was House of Leaves. The footnotes took on more than a life of their own, sending the reader forward and back through the book, as though navigating the titular...

        Ergodic literature is a mode of textual organization in which nontrivial effort is required for the reader to traverse the text, beyond ordinary eye movement or turning pages.

        The common example back in my day was House of Leaves. The footnotes took on more than a life of their own, sending the reader forward and back through the book, as though navigating the titular labyrinthine house.

        In Snuggle Squiggle's writing, most notably Weave Me Another Cocoon, one must often navigate the story's unfolding through notes hidden in clickable...

        ... <details> elements.

        (TIL how Tildes handles those, haha.)

        6 votes
        1. [2]
          lou
          Link Parent
          I understand. Are comic books a kind of ergodic text?

          I understand. Are comic books a kind of ergodic text?

          2 votes
          1. gryfft
            (edited )
            Link Parent
            Not necessarily, I think. If you can read the panels mostly left-to-right*, top-to-bottom, without having to put too much thought into it, it wouldn't count in my mind. Some comic books/graphic...

            Not necessarily, I think. If you can read the panels mostly left-to-right*, top-to-bottom, without having to put too much thought into it, it wouldn't count in my mind.

            Some comic books/graphic novels certainly are ergodic literature; Meanwhile by Jason Shiga is one excellent example. It's a supercharged, semi-looping choose-your-own-adventure connected by illustrated tubes and physical tabs on the pages.

            As a rule of thumb, I think if you ever have to hold the book upside down, hold it up to a mirror, or read sections in an arbitrary order based on your own choices, one is dealing with ergodic text.

            * or right-to-left in manga
            2 votes
  2. [2]
    lily
    Link
    I've been working on my own lightweight markup language recently so this is relevant for me. There are some interesting suggestions here, but some of them (like e.g. <details> support) come in...

    I've been working on my own lightweight markup language recently so this is relevant for me. There are some interesting suggestions here, but some of them (like e.g. <details> support) come in conflict with my desire to not be completely tied to HTML. There's a bit of a weird balance there, where in reality I'm only ever rendering as HTML and don't have any use for other output formats, but at the same time don't feel right effectively making my language an HTML shorthand in the way Markdown is. I've found it tough to settle on a good set of semantics because of that.

    1 vote
    1. acdw
      Link Parent
      Hey I have too! If you're interested in comparing notes I'd love to talk shop.

      Hey I have too! If you're interested in comparing notes I'd love to talk shop.

      1 vote