HACKER Q&A
📣 rco8786

What's the best platform for technical writing in 2022?


Over the years I've been writing notes, documents, articles mainly for myself. But as I get older and further in my career I'm realizing there's probably value in sharing these with other folks...but I don't know the best avenue for doing this anymore. And selfishly wouldn't mind building up a bit of an audience for myself in the process.

Are personal blogs dead? Medium? Substack? Something else entirely?


  👤 glacials Accepted Answer ✓
After a long journey jumping around I’ve recently started writing plain HTML files in GitHub Pages with a custom domain and I have been loving it.

I’ve been on WordPress, Blogger, Medium, a custom Vue site, a custom Go server, a Raspberry Pi, the works. Each was either a platform that could rot, or a hobby that could distract me from writing. Raw HTML on GitHub Pages has solved both these problems for me.


👤 sirodoht
* I make https://mataroa.blog/ It’s a simple blogging engine with an import functionality. One idea would be to just import everything there (assuming they are just text files). Eventually automate this process to keep everything up-to-date.

* Similar problem statement by Stavros in this website: https://notes.stavros.io/ He’s using Joplin [1] to write and then exports everything in an mdbook [2].

[1]: https://joplinapp.org/

[2]: https://github.com/rust-lang/mdBook


👤 mooreds
If you just want to write, I'd go with wordpress and then syndicate to medium. I don't know if you can syndicate to substack.

Set up a mailchimp mailing list account and have the RSS feed publish a newsletter.

You didn't mention wanting to monetize your content, but if you do, then that's when I'd look at substack. In my experience, it's far easier to monetize your content by showing proof of authority for a better job or consulting than by selling access to knowledge. But your niche may be more monetizable than my experience.


👤 buscoquadnary
Doom Emacs + org-mode. Export as HTML upload to webpage, lasts forever, doesn't require a bunch of upkeep, and don't get distracted by all the other things.

👤 mamcx
I use https://obsidian.md now and is nicer than expected. I publish with https://www.getzola.org/ for online stuff.

👤 adulakis
I am developing https://giteditor.app as I felt that hosting the content on git and publishing with JAMStack is an ideal combination. What I always felt was missing though, was an easy and quick way to create a note without all the git steps.

👤 juancn
It depends. For some things, when it gets really technical, I use LaTeX, and I use TeXShop as an editor. It has a nice side-by-side view of the source code and the generated PDF.

For an intranet, something like Atlassian Confluence does the trick (with LucidCharts for complex graphics).

Public web-based consumption, a markdown doc on github usually does the trick, unless you need something fancy, in that case, you kind of need to fall back to HTML.

I've played a bit with Jupyter notebooks, but I haven't done anything serious with it. I need to look at https://github.com/jupyterlite/jupyterlite for complex embeddings.


👤 garyfirestorm
I don’t write but i have always been intrigued about a pipeline for efficiently writing and publishing. I came across https://hemingwayapp.com/ - you can buy the desktop version and it allows you to directly publish to Wordpress or other places. I have never tried it, but it’s supposed to be a minimalist editor. Give it a shot.

Edit - I did buy the app, I have not tried publishing thru it.


👤 k__
The most crucial part is a setup that lowers the barrier to publish.

Something that you like to use regularly.


👤 dpwiese
I had a nice experience using Hugo for https://danielwiese.com and deployed with Github pages - I was really happy with the easy setup and writing process. The other alternative I considered Jekyll.

👤 gls2ro
I would recommend the following that I used so far:

1. Substack - as it is a nice combination between a blog and a newsletter. So anyone that wants to subscribe can do it but also you can just share the article like a normal blog. It supports bringing your own domain which I would recommend from the beginning and also they can export your data but in HTML files. It has basic support for syntax highlighting.

2. Hashnode - it has more support for syntax highlighting, it saves your blog post if you want as markdown directly in Github and it also supports bringing your own domain. The only thing that I don't understand about Hashnode is their business model :)


👤 kqr
I used to publish a personal blog solely in Emacs. Then I upgraded my Emacs version and some quirks I relied on got fixed, so I can't publish anymore. I also got children to take care of, so I can't spend much time taking care of a somewhat brittle configuration.

I'm thinking about either

- containerising an older Emacs version configured just for this,

- hosting something like WordPress on my own, or

- looking for a hosted alternative.

I heard Drutopia was run as a co-operative which seems like a great idea for a writing platform. However, it doesn't seem that way from their website.

If you know of a co-op in this space, let me know!


👤 35mm
Self hosted Wordpress on a cloud VPS for around $5 / mo.

Build an email newsletter.


👤 synicalx
I feel like I might be alone in this, but I find Github + some markdown docs organised into folders to be perfectly fine. Redirect a personal domain to your github repo if you really want, I personally don't bother.

People can clone/fork it, open PR's, see revision history, and its very portable. Probably a terrible choice for natural search discovery though, I assume so maybe not ideal if you want people to be able to just stumble across it while searching.


👤 FelipeRM
It depends.

Self-publishing is not always the best option. Maybe you can start writing for a well established magazine/blog. This may help you to build your 'audience'.

If you want to go on your own, I think the best is first to define what are your goals, from that you can choose if your best option is a blog, a newsletter or a book.

Every platform has its advantages and big disadvantages but choosing one is a matter of your audience's preferred channel to stay in contact with your work.



👤 efitz
Did I miss the EMACS post? Cause you know it’s coming.

👤 cpach
My preference is to use Hugo on my own domains.

I keep my repos on GitHub. For deployment I use AWS Amplify, which is dirt cheap and incredibly convenient. No maintenance needed at all. It just works (once you have learned Hugo).

Addendum: If you don’t like GitHub, you can self-host your Git repos instead. If you don’t like AWS, you can instead use a small VPS at whatever provider you prefer.


👤 softwarebeware
I feel you should instead look for paying jobs contributing to existing blogs that have high readership. Baeldung.com for one example.

👤 vinner_roy
I'm building pagespace.app to address this need for myself as I was also looking for a place to share knowledge that spans multiple pages (with the option of selling via subscriptions or one-off purchases). Would love to hear what I can do to make the platform attractive for this use-case!

👤 egberts1
Still waiting for the last magical but portable CI/CO conversion step of dropping in a Markdown and getting the SSG website.

GitHub has one CI but is only output is to GitHub Pages (username.GitHub.io) and only with Pelican SSG.


👤 taubek

👤 shishy
This is maybe what you're looking for -- https://neuron.zettel.page/

👤 ausbah
I use a minimalistic Jekyll build hosted on Github pages. definitely not self hosted, but takes maybe an hour to setup with a custom domain

👤 byteski
the best platform is your own (website) platform

👤 slowboat
I use iA Writer, it uses markdown. It's quite a minimalist experience, export to html and pdf is available.

👤 suyash
Your own site

👤 taubek
I've switched recently from WordPress to Jekyll on GitHub.

👤 nvarsj
Sign up to wordpress.com, find a decent looking theme, done.


👤 GeneWilburn
If you’re doing technical writing for clients, they’ll frequently want your submission in Word format.

For blog writing Medium is decent. Wordpress isn’t bad either.


👤 pmlnr
HTML files.

👤 slavapestov
TeX

👤 simne
I think, now are strange times, looks like for really wide distribution, need to switch to video (podcast) format - youtube, tiktok, share podcasts through app stores (Apple/Google/Sony).

So, writing will become screenwriting, or make presentations.

Podcasts, are for people, who listen them while commute, or while waiting in queue, or while do gym exercises, or something like these.

For just text format, I think, just upload to github is good enough for many cases.

But if you want to see real value of your texts, mind about make small books for read on Amazon Kindle, or other reading platform (now Apple have such service, and Google, and many smaller companies). May be good fit Patreon. Mean, if people pay for your work, they really value your work.