Pandoc Templates

(pandoc-templates.org)

196 points | by ankitg12 4 hours ago

11 comments

  • ktzar 1 hour ago
    Pandoc is such an amazing piece of software. I used it to format my novel and made it part of a GitHub action to produce all the formats I required. I wasn't aware of templates, but some look really sleek.

    I keep thinking that modern text editors are just flawed and markdown, with all its downsides and limitations, is what 99% is the people need.

    • abyssin 12 minutes ago
      You may be overestimating technical abilities of 99% of the people. I tried to convert some to pandoc and failed miserably. Personally I love it, markdown is becoming more and more central to my workflows.
    • adamddev1 6 minutes ago
      Haskell thriving in the wild!
    • maxerickson 1 hour ago
      For the short, simple documents that most people make, a versioned, wysiwyg word processor is going to beat everything else.

      I mean, they don't want to think about building the output, never mind controlling the process.

      • troyvit 13 minutes ago
        Building my resume in a wysiwyg editor was an exercise in frustration. Formatting was inconsistent, they were only searchable from inside the editor and versioning was useless because diff had no meaning.

        My markdown resume has its own problems but having this level of control has been a huge load off my mind.

      • limagnolia 33 minutes ago
        For most of the short simple documents I create, I don't want to redo the formating for every document. Simply writing it in something simple like Markdown ( possibly a markdown wysiwig editor) and having my software automatically apply appropriate standard formats to it is ideal.
        • maxerickson 14 minutes ago
          Right, most people don't want to do that, they want the burden of applying styles to the couple headings or whatever.

          Unfortunately, most people don't use paragraph styles, but if you do, it's a couple clicks.

          • sgc 4 minutes ago
            Agreed. There is actually a lot better control in openoffice / libreoffice than most people know. You just have to set up your styles and be systematic about (virtually) never using direct formatting, instead always applying a pre-configured style. There is a distinct value in seeing your final product as you work, when the final product is visual.
  • FailMore 8 minutes ago
    I’ve been building something somewhat adjacent to this. It’s https://sdocs.dev. It’s as 100% private browser based Markdown renderer
  • wodenokoto 31 minutes ago
    I’ve been looking for a template to use for fancy business reports, so I can do my stuff in R/Python/QMD and management can get something colorful to look at without me having to copy paste everything into PowerPoint
  • chlaunchla 41 minutes ago
    Pandoc is an impressive piece of software but I could never quite get PDF generation working nicely with it.

    Table layouts were often broken, with text overlapping into adjacent fields. Unicode font fallback didn't work properly, with characters like "→" being silently dropped because they didn't exist in the main font. Having predictable control of page breaks, to avoid situations where header text didn't stick to the following paragraph and instead had header and paragraph text split over a page boundary, was pretty much impossible.

    I ended up concluding that Markdown isn't a sufficiently powerful markup language for page-based documents, and went back to using Word in all its WYSIWYG delight.

    That said, maybe there were ways of doing all of the above but I couldn't figure it out and found the whole process of wrestling with with both Markdown and LaTeX templates, and Pandoc configuration, unintuitive and annoying.

  • thibaut_barrere 1 hour ago
    Somehow related is https://www.metanorma.org/ (using Markdown to produce norms-compatible outputs).
  • falsaberN1 45 minutes ago
    Oh wow, I use Pandoc fairly extensively, and have my own templates, and I never knew you could make things as colorful as some of these.

    Oh no, inspiration has arrived. Guess I know what I'm wasting my weekend into, hah.

    Also this page seems to have existed for a while and I never heard of it! I'm glad I stumbled upon this. A lot of nice ideas here.

  • abyssin 10 minutes ago
    [delayed]
  • submeta 1 hour ago
    I am a heavy user of Pandoc. As I write all my text in markdown using Obsidian, but have to create content for the MS Office environment, I use Pandoc to convert my markdown content into ms office formated content.

    I would be lost had I have to use the Office tools to edit and format my text.

    So thank you to all the maintainers of Pandoc.

    • ltrg 1 hour ago
      I used it to output my doctoral thesis in LaTeX from Markdown 10 years ago, and similarly for going back and forth between my supervisor's Word documents and the main thesis text.

      Embarrassingly, a horrible little script for converting Pandoc's Markdown endnotes to inline format remains my most-starred GitHub repo: https://github.com/ltrgoddard/inliner/

    • maxerickson 1 hour ago
      Basic familiarity with the paragraph styles in Word is like a 20 minute task.

      If you are using markdown, you already understand the conceptual basis for it, so you just need to understand how it's implemented over there.

      I'm not arguing that it is something you should do, just rolling my eyes at "I would be lost".

      • submeta 1 hour ago
        Not lost because it's hard to learn, but because I don't like writing in ms office products. It's not just word, I write formated long emails in outlook as well.
    • mkovach 1 hour ago
      [dead]
  • ntnsndr 1 hour ago
    I have been relying on pandoc for many years and had no idea I could use templates like this, which I suppose is pathetic but also indicates just how powerful the defaults are on their own.
  • djyde 1 hour ago
    I've always wanted to make a GUI client for pandoc
  • raffael_de 2 hours ago
    2 hours, 56 points and not a single comment?
    • RadiozRadioz 1 hour ago
      Perhaps people are quasi-bookmarking it