I'm writing a paper, and I've found a decent approach to keep things organized:

1) Everything is in a repo, and i collaborate with the other authors through (private repo, for now).
Changes to the text are discussed through github issues and PR.

2) To overcome writer's block I wrote a one line comment where each paragraph will be, so that I get an idea of the logic of the paper.
The paragraphs then are folded (using ) into the one line summaries, to keep the overview.

Sounds really good. I've been looking for a solution to #2 every now and then, i.e. how to toggle between viewing the full text and an outline without maintaining separate files.

Come to think of it, maybe occur mode could do this with some kind of markers for the outline elements (I'm using emacs)

Does it still work if the file is a *. tex? I'm not very familiar with org-mode, but I've heard extraordinarily good things about it.

@mprv @mmin I believe org mode supports embedding LaTeX though I haven't tried it. I just scratch the surface of org-mode functionality for my general note-taking!

I used org for some time but then my configuration started getting more and more complicated and emacs was slowing down on my work computer. I use pandoc so I'm now staying with simpler pandoc markdown. I know that you can only use org for simple stuff but for me it was a rabbit hole 😀

image/svg+xml Follow

@mmin @mprv pandoc has proved excellent the couple of times I've needed it, I think I'll look into pandoc markdown. Sometimes I spend so long putting together a nice elegant workflow I forget it was supposed to be to 'save time' in the first place 😬

I used pandoc too for a while, and I still think that most papers could be written in markdown.
This workflow should be language independent, though: you can version control *anything* 😁

And the other thing is mostly a mental order question (and editor capability).

What does your workflow look like?

@mprv @jamie I agree that language independence is important. My previous workflow was built around org and then supplemented with org-bibtex and org-brain (a mindmap extension), but for some reason this was very slow and was becoming unwieldy. Now I use zotero for references and reading notes, a paper notebook for quick notes and tiddlywiki for more permanent notes.

But this seems to be constantly a work in progress 😀

Nice! How's tiddlywiki? I tried using a personal wiki for my notes but I've not found one that has decent math support.

I'll probably keep handwriting things and use my filesystem to keep them sorted.

And don't worry, these things are always a work in progress, that's why we need open, language independent solutions 😉


I like tiddlywiki a lot although setting up is nontrivial. It needs a browser plugin and the wiki needs to be under the downloads directory, otherwise it can't save with modern browsers. Once it works, it's really nice because you can use tags, links etc. You can even visualise the network with the tiddlymap plugin. Can't say about math support.

To be honest though I overestimated my need for a research wiki. I haven't used it nearly as much as I initially thought.

Sign in to participate in the conversation
Scholar Social

Scholar Social is a microblogging platform for researchers, grad students, librarians, archivists, undergrads, academically inclined high schoolers, educators of all levels, journal editors, research assistants, professors, administrators—anyone involved in academia who is willing to engage with others respectfully. Read more ...