{"id":37731,"date":"2022-11-25T16:09:36","date_gmt":"2022-11-25T21:09:36","guid":{"rendered":"https:\/\/mjtsai.com\/blog\/?p=37731"},"modified":"2022-11-25T16:09:36","modified_gmt":"2022-11-25T21:09:36","slug":"outlining-and-documents","status":"publish","type":"post","link":"https:\/\/mjtsai.com\/blog\/2022\/11\/25\/outlining-and-documents\/","title":{"rendered":"Outlining and Documents"},"content":{"rendered":"

Dr. Drang<\/a>:<\/p>\n

\n

I’ve always had this silly belief that I should be able to convert an outline into the skeleton of a report (or a blog post or whatever, but it’s usually a report) more or less automatically and then flesh it out into a final product. This doesn’t work because, except for the items at the top-level, the various items and subitems in outlines don’t correspond perfectly to sections and subsections of a report. Some outline items are<\/em> subsections, but most are paragraphs or lists within a subsection. There’s no general way of knowing what an outline item is; its level doesn’t offer enough information to slot it into the proper place in the report.<\/p>\n<\/blockquote>\n

This has been an issue for me, too. I find outliners to be great for taking notes and for working on and rearranging ideas. But then there’s an inevitable break to get from there to get from there to the final output, if it is to be a document.<\/p>\n

\n

I confess this way of working still nags at me. Surely, the back of my brain says, there must<\/em> be a way to avoid the repetition. But the front of my brain argues back that years of trying have never led to that magical solution. There’s no way to avoid the actual work of writing.<\/p>\n<\/blockquote>\n

Aside from the repetition, it’s a one-way transformation. Once you’re in the document format, you lose the ability to do certain outliner things. Fortunately, most of my writing these days is in Markdown, reStructuredText, or HTML, and BBEdit has some tools for navigating and collapsing those structures.<\/p>\n

You may be wondering how I can show Example.html<\/code> on my iPad as I’m writing a report. Unlike Safari on the Mac, Safari on the iPad cannot open local files. There are two ways to get around this[…]<\/p>\n<\/blockquote>\n\n

Previously:<\/p>\n