Ask HN: Best Tools for Technical Writing? What tool do you use or recommend when drafting technical blog posts or books? I've found that editors tend to do one thing or the other very well: they're either really good editors for rich text and multimedia or really good editors for code. What tools balance the best of both worlds? |
Researchers use LaTeX heavily for papers. It has a learning curve, but once mastered it is very powerful.
Markdown is being increasingly used for code documentation nowadays. `readthedocs`, github pages work well with markdown syntax
Publishers tend to layout professional documents with Adobe Illustrator / InDesign. All the common magazines generally use it, unless they have some custom sauce built-to-order
Of course, when using markdown(/mermaid/tikz/etc.) creating diagrams is severely limited unlike point and click alternatives. I haven’t seen a good solution yet that isn’t too restrictive or slow.
It's like a markdown editor with some code editor features, like for example multi cursor/selection, auto bracket closing, option + up/down to move/reorder lines, things like that. The "hide markdown" function makes it very nice to read as well.
It works on plain markdown files, which is really convenient for many things. No subscription, just a very reasonable one time price (they used to have a free trial/beta, I don't know if that's still the case).
I use it to draft pretty much everything I write, I just copy paste to confluence/gdocs/slack/wherever.
Notion if you want to quickly share things. But I would recommend using something else because they don't have offline support and they don't allow downloading pdf format of nested articles without a paid tier. Also no vim bindings. But I still use it as super fast to share, easily formattable and looks nice.
https://jupyterbook.org provides the book stuff - toc, bibliography, sequential numbering for chapters, sections, equations, figures, tables, ...
Why? The outliner mode in that was super productive. Everything since is a piece of junk.