4 ms·
I feel like pandoc is kind of like a secret club. Once you know about pandoc, you orient all of your prose around it, because it's so powerful and useful. But
by gen220 6y ago
I feel like pandoc is kind of like a secret club.
Once you know about pandoc, you orient all of your prose around it, because it's so powerful and useful.
But before you use it, the common opinion is "oh that sounds nice", not "oh let me build all of my workflows around it".
It is incredible how far markdown, sed and pandoc (with filters) can take you!
I've made websites with breadcrumbs, validated inter-document links and images, on and on; mostly pipelines with sed and pandoc.
All of my non-source-code homework in college went through pandoc, and was persisted as markdown source. It makes for clean diffs, and great version history.
Anyway. Give pandoc a try if you haven't already.
- leephillips 6y agoI’m with you. And it’s true that’s it’s hard to take account of your own perspective. It’s possible to write a kind of story of Markdown and not make Pandoc a big part of it. But it seems like a glaring omission to not even mention it. It‘s what makes Markdown a real lingua franca, what gives it real power.
- kstrauser 6y agoOne of the prouder moments in life was convincing a legal team to convert a folder of Word docs to Markdown, check them into GitHub, and set up a CI/CD pipeline to convert them to PDFs to sharing.
- leephillips 6y agoThat sounds like quite an accomplishment. At this point I don’t even think I would try.
- kstrauser 6y agoHard parts: - It's Markdown, not Word - Finding an editor that felt comfortable. (BTW, iA Writer is awesome for this.) Easy parts: - "You never have to care about formatting again!" - "Two people can edit stuff at the same time and we can work out the differences later, instead of playing the 'who has the most recent version?' game." - "Look, you just write text and a nice document with logos pops out the other side, and all of the documents look nearly identical without even trying!" - "Git shows you the full history of every line of this file." - "Hey, cryptographic signatures you can use to irrefutably prove the history of the document!" - "This 'pull request' thing in GitHub shows you exactly the changes you made, like 'track changes' except they're all in one place!"
- TacticalTable 6y agoSeconding iA Writer. I especially enjoy the focus and editing modes.
- gen220 6y agoThe easy parts are what make it a selling product. I'd love to see "github for non-developers", that is little more than a markdown-app, with a thin wrapper around some git server and pandoc. Most CMSs implement all the hard stuff (version control, document generation) themselves, but exposing some of the "knobs" of pandoc/markdown/git and letting users run amok is kind of all you need to do, imo. Confluence is kind of like this, but limited to the production of web pages.
- kstrauser 6y agoThe idea had crossed my mind.
- barumi 6y ago> I'd love to see "github for non-developers", that is little more than a markdown-app, with a thin wrapper around some git server and pandoc. Aren't you describing a wiki?
- gen220 6y agoSort of. (See my last sentence in the above sentence, about how “confluence is close”). Wikis are limited to rendering information in a webpage format. The benefit of pandoc is that you can render it in any format you like, with arbitrary filters and styling. So you can display the content in a webpage, but you can also render it into PDFs with full legal headers and footers, and footnotes with links, to be physically printed and mailed to people. It’s a level of abstraction once removed from a wiki.
- ricksharp 6y agoNice! I’m teaching my children to write their school papers in markdown for similar reasons. I use a github PR to provide feedback.
- pbronez 6y agoWas Markdown really sufficient for you? I’ve tried to do this for a contract workflow, but always needed something like Asciidoc to get sufficient internal references, header numbering, tables, etc
- kstrauser 6y agoSo far. Pandoc’s Markdown has been sufficient to the job.
- barumi 6y ago> One of the prouder moments in life was convincing a legal team to convert a folder of Word docs to Markdown, check them into GitHub, and set up a CI/CD pipeline to convert them to PDFs to sharing. Why would you want to do that? I mean, I don't understand why would anyone have to have and maintain a CICD pipeline just to be able to share a PDF.
- kstrauser 6y agoFor a PDF? No way! For a whole set of PDFs sharing the same template, some containing auto-generated data and with builds triggered by external events? Oh yeah! Also, read the second half of my other reply for the other reasons it was adopted.
- barumi 6y ago> For a PDF? No way! For a whole set of PDFs sharing the same template, some containing auto-generated data and with builds triggered by external events? Oh yeah! You do not need a full blown CICD pipeline or git or anything at all to do that. Even LibreOffice, of all things, has doc templates and doc includes. Hell, have you ever heard of TeX/LaTeX? People have been using it for decades for the same effect. You write the text, generate the doc, and you're set. There's no need to go all-in on a resume-driven-development rampage. I mean, why on earth would anyone force any cleric worker to read up on GitHub Actions just to be able to send a report? You can't really justify that, can you?
- kstrauser 6y agoK
- jkmcf 6y agoIt's a fascinating achievement! I, and others at my org, want to do this for technical writing. Some want LaTex -- others Markdown -- so we must answer that question first. Did you implement an example for them, demonstrate, and get acceptance? What was the resistance? How was it overcome?