The fiction publishing world is cutthroat competitive. Trying to use nonstandard tools / “breaking the mold” adds even more friction to success.
But anyway, I do use Markdown and I have submitted to contests etc. that require Word formatted files. For the most part it's an nonissue. I can use Pandoc to export to Word, provide the reference file with the correct format, and boom, I'm done. None of the judges of my works so far have ever had any issues opening my files.
I agree the publishing industry will never accept Markdown. That's ok. I can use the tools I like and still produce what they need to do their part of the job.
For a novelist, though, the editing process is quite iterative: make changes, send them to your editor, they send it back with comments and inline track changes and so on.
Don't get me wrong, I'm an advocate for using tools you're most comfortable with...whatever gets you writing! But these small things can throw a wrench in the process. It sure sucks to have to do edits in Word!
Good luck with the publishing project, though, it sounds like you're pretty far along!
Primarily, all a writer does is write plain text. Probably less than 1% of sentences are anything other than plain text.
There's not a lot of headings or titles. There's not a lot of italics or bold text.
What else is there? What am I missing? What's the benefit?
What exactly does MS Word add over markdown which matters to an author? I am talking about the writing experience. You could always export to docx.
No offense but you don't sound like someone who writes a lot?
The most obvious WYSIWYG competitor for novelWriter is Scrivener, which is similar to Ulysses -- and also shares the limitation that it can only export to Word rather than import. Nevertheless, its testimonials page is filled with praise from people who arguably write more than I do. :)
Some people may need "special characters" they can't type, but I have keybindings for the characters I use.
Grammar checking and corrections is my proofreaders job, not mine. It happens after I've converted my document and sent it off.
Macros are supported in pretty much every editor I've ever used for plain-text. I use lots of macros, but exactly zero of them for my novels.
I don't need to send and receive documents with no conversion needed. I do one export when I'm done with my first draft, and then I edit and do one more export before handing it over to my proofreader. Then, sure, I review those changes in Librewriter. The proportion of my time that takes is tiny. It'd be nice not to have to, but I'd take that over having to work in a word processor during writing any day.
> No offense but you don't sound like someone who writes a lot?
As someone who has written several novels, that's how your comment came across to me. At the same time I know novelists range from the pen and paper type (e.g. Gaiman, King to give two examples discussed in this thread) up to wanting word processors with all bells and whistles - it's very much down to taste.
* Inserting special characters: personally I don't find those "character choosing" windows to be very convenient. Hunt and peck is a slow way to type! Anyway, you can do this in Markdown with either Unicode (if you have the right keyboard) or you can write HTML escape codes (&tm; etc.)
* Automatic (grammar/spelling). I don't like check as I type, but sure. Anyway, Emacs provides this if I want it.
* Macros. Hello? Emacs? (Also, Pandoc has a scripting interface.)
I may not be published yet but I've written my own book. I've also published books for other people. I did both of those with a Markdown-based toolchain. It works.
Edit: Just to prove the point: https://www.amazon.com/dp/0692553916 . Go see for yourself how the book is formatted.
(Also, I wrote a Markdown-to-ePub script, too! Although I don't think anything I've got up online uses it anymore.)
I'm a Markdown fan, but really there _are_ better solutions for book writing that maintain the ease that Markdown brings. Things like ASCIIDoc.
Also, if emacs was good enough for Neal Stephenson, I'm sold...though I hear he uses Scrivener now!
What does Markdown get me that makes it worth switching to for the first draft only?
Hemingway famously favoured pencils for his first draft and switched to typewriter for his second.
Gaiman and Stephen King uses pens for at least their first drafts. Gaiman expressly for the reason that he believes it force him to be more thoughtful and forces him to go back and rewrite the full book word for word rather than going back and forth to edit. King switched to pens after his car accident.
JK Rowling wrote Harry Potter with pen on loose sheaf paper.
Writing novels is intensely personal, to the point where writers will insist on specific brands of pens or specific models of typewriters. E.g. Danielle Steele has used 1946 Olympia's throughout her entire career.
i am not yet there in the process, but i won't be using plain text/markdown just for the first draft.
when i get back that word documents with comments from the editor, i'll look at that like a read-only copy, and actually make the required edits in that same plain text editor.
while it may be easier to make edits right in place in the word document, it is easier (for me at least) to keep a history of changes with plain text documents.
otherwise i'd agree with you. if you are going to end up editing in word, may as well start with editing in word. for me the goal is to avoid using word/libreoffice at all.
> what an author should want
That is normative / prescriptive attitude, and seems to gatekeep who gets called "an author."
On the other hand, I think the biggest challenges most writers have is getting words on (digital) paper, regardless of the software.
I am also unconvinced that there are any practical benefits (for me) to using Markdown in particular, instead of whatever is closest to hand and offers the least friction...use what works for you!
I think others have an opposite view, but on the same grounds. The argument seems to be: it's all plain text, so docx is overkill, so markdown is more technically efficient!
There's some benefit to using the tool I know best (emacs, for me), so it's nice to use a "native" format that also gives me my usual keybindings, macros, etc.
But there's no doubt it just offloads the inefficiency to a different step of the process. I'm more comfortable with inputting text, but it requires post-hoc reformatting, and I'd have to use a different word processor for post-editor changes...
The "markdown is a more efficient solution from a technical perspective" argument doesn't hold a lot of weight with me...the practical overhead of docx is minimal, so unless you prize technical purity over all else, I don't think there _is_ a benefit.
Another example: because formatting is reified in Markdown, I can grep for it. Did I misuse italics? With one command I can find every single place where I used italics in my entire book. I don't think you can even do that in Word. Good luck reading a multi-hundred page manuscript to find all of the places you may have made the same mistake.
Another example: Word provides styles, but honestly, who has discipline to use them? Most people I know manually insert page breaks, centered text, and X number blank spaces at the top of a page to make a new chapter. In Markdown, all of my markup gets converted into Word styles automatically and then I can create a reference doc to apply the style I want. I'm writing semantically correct styles in my documents all the time with no additional effort.
And, find-and-replace for specific formatting is supported out-of-the-box.
Finally, cmd-i / cmd-u / cmd-b are pretty easy default bindings, and setting up shortcuts for more intricate, specific styles is straightforward in Word.
I share your preference for using an efficient tool—I'm a die-hard md+git practitioner. But the "most people I know" argument is not a good basis for rejecting real, rich features in software that works well for other people.
I am also curious: why do you care about semantic correctness? It's OK if that's just your preference, but it's not something that moves the needle for me....I'm not sure why I should care!
(edit to add: my comment sounds glib and a little sharper that I intended. That wasn't my intent!)
> Version history in Office only works for files stored in OneDrive or SharePoint in Microsoft 365.
> https://support.microsoft.com/en-us/office/view-previous-ver...
Or alternatively you can sort of hack it with track changes, but it's not automatic and there is a long list of caveats. In short, track changes is really intended for a single round of changes on top of a base document, not for permanently tracking the changes on a document over its entire lifetime:
https://support.microsoft.com/en-us/office/view-previous-ver...
Now maybe a Word expert will come along and tell me how to do it properly. :-) But even if they do that sort of proves my point, which is that Word is a large, complex piece of software and even if it hypothetically supports some feature, doesn't make it intuitive or easy to use in that way. (Or that you won't hit a bunch of corner cases when you try to use it.)
I do stand corrected about the find-replace formatting, so thanks for that. But on the other hand, I don't think it really contradicts my point either.
To be clear, I do think Word serves its user base! For low- to moderate- tech savvy users, it's does exactly what it needs to. And I'm not saying everyone should switch to Markdown. But for those of us who have the technical chops to go beyond it, there are some real advantages to working with other tools that shouldn't be discounted.
> a large, complex piece of software and even if it hypothetically supports some feature, doesn't make it intuitive or easy to use in that way. (Or that you won't hit a bunch of corner cases when you try to use it.)
A takeaway I get from this entire conversation is that the real pain point is not the drafting stage, but the editing stage. The latter is (a) collaborative, with (b) non-technical stakeholders...there doesn't seem to be a good way to both use my favorite editor, AND play nicely w my editor's stack (or lack thereof).
Good thing I don't have an editor...that would require me to actually write things :D
This is only true while track changes is on, correct? Like can I see the state of a docx as I was writing it last month/year?
But if you cared about the history, why wouldn't you always turn them on by default? "Full history" in git is also an opt-in model for maintaining a history...
(Serious question—a big pain point for me is the choice between using my preferred tool to start, then switching to a bad tool later; or, using a bad tool the entire time)
Another way that seems to work well for some writers and editors is a shared Google Doc.
I could never get over Markdown; Markdown doesn't show me the user experience of my own code(writing), while word and scrivener will show me instantly.
If you are working with plain text, use something that excels at working with text. I saw another of his talks, and how he works in Emacs is amazing.
The point of using markdown is that you got many tools which are superior is aiding in you writing process and organizing your text.
The final format is much less important than whatever aids your writing process.
I have tried using traditional word processors for writing novels and I cannot say they measure up to tools like Ulysses.
Word automates a lot of things in the editing cycle of a novel. Word's "Track Changes"/"Accept Changes" tools and the workflows they enable are by far the most common in a number of industries, but especially in edit workflows of most major publishers. That's why the Word format specifically is often requested/required, because people know and understand those tools and already have processes/workflows built around them.
The closest equivalent tools for plain text are source control systems and text diff/patch. Those tools are great (and arguably fit some definitions of "superior", especially in capturing history earlier in the process and keeping history longer after the process). They are also nowhere as ubiquitously installed as Word, and nowhere near as easily taught (or already known/understood) as Word in today's world.
Those "edit cycle" needs maybe aren't a huge reason to do the initial writing in Word, but they are certainly many steps above "no value", and thus the noted restriction that no matter what tool you use for the initial writing, if it doesn't have an easy Word export to get it started down the edit cycle path then it doesn't have an easy fit in today's publishing world.
Is it sarcasm? I mean... make corrections/changes is what an editor does.
> The core export format of novelWriter is HTML5. You can also export the entire project as a single novelWriter Markdown-flavour document. In addition, other exports to Open Document, PDF, and plain text is offered through the Qt library, although with limitations to formatting.
So it seems like it can export to Open Document, which seems to be well-supported[1]; including Microsoft Office support.
[1]: https://en.wikipedia.org/wiki/OpenDocument#Application_suppo...
Is it though? I don't have any experience with book authoring but I would expect stuff like Geronimo Stilton to be hard to produce with markdown: it is peppered with creative text highlighting (e.g. words written in a custom cheese-pattern font) and this is common in primary school geared books.
Even decidedly grown-up books like GEB might have illustrations and diagrams, and it's important to consider where said illustrations go - they must fit in a physical page.
There are also other small quality of life things that word does automatically, e.g. replace ASCII 0x22 (keyboard quote) with 0x201C / 0x201D (left and right double quotes, respectively), etc.
Don't get me wrong, I love to use markdown for programming documentation and it's pretty good for that, especially when you adopt flavors like GFM. But I'm legitimately curious what makes one consider markdown superior for book writing. It just seems like it would have a different set of priorities.
And yeah, you have the invisible format issue but at least you can make tables and resize them with your mouse.
Markdown's value add comes from having really good implementations to transform it into rich text, and being "unambiguous" (it's not really in a lot of cases but there aren't many great alternatives with widespread implementation).
But like... Word is pretty magical overall.
Basically, it's an outliner/corkboard/project manager for all kinds writers who uses Word.
Markdown would be much better for authors. Just because they have become accustomed to something else doesn’t mean that something else is better.
Just watching the mess my dad makes when writing books in Word makes me convinced that anybody who claims Word is superior for an author simply have never watched and author in action.
Something like:
$ brew install pandoc (install on macOS)
$ pandoc -t docx filename.md -o filename.docx
Ref: https://opensource.com/article/19/5/convert-markdown-to-word...
Cross platform support (including iPad), saving direct to dropbox, full screen distraction free mode, easy sorting of chapters / scenes, rapid offline export to PDF (unlike say Celtex). Scrivener just blows everything else I've used to write out of the water.
Working draft for current one is in Ulysses but I’m not feeling it ATM so might switch
They're technical books rather than novels so although I prefer markdown I find it doesn't quite stretch far enough for me
TeaDrunk said it best: it’s now significantly more steps the user shouldn’t have to do.
You and parent commenter seem to think that you are disagreeing with what I said but we are agreeing.
I think the bigger issue if she already likes Scrivener is that if that is the functionality she wants, then unless she wants the flexibility of being able to customise a tool or process Markdown files with code or switch to Linux etc. is something she wants, then it's not likely the tools you've pitched, or this one, will be an improvement.
I write in Markdown myself, so I absolutely sympathise with your POV on that, but I think the "rock solid word export" is more of a way to get you off her back because it works.
Every top dog eventually gets cut down by _someone_ over time.
(I just deleted a paragraph of text so that I don't influence your response with my own opinions.)
In general, I think we should strive for non-proprietary, standard file formats.
Isn't docx far too one-sided and controlled in that regard? I wonder if anyone has some info on the "state of affairs" for the "document format race".
A minimum for a novel writing tool is that one can actually send the novel out in a format where your agent and editor will read it. Otherwise you're not getting that novel published.
My partner tells me that it has to be formatted a certain way down to the font and line spacing too or they won't accept it.
I'm cracking up at all these comments suggesting that her recipients brew install pandoc lol. Good luck with that.
When startups haven't even started up yet but are worrying about how they can scale to billion-dollar unicorn level, a common refrain on Hacker News has been "you are not Google."
Allow me to give you the fiction writers' equivalent: you are not George R.R. Martin.
And if you want to let it proof read by George R.R. Martin you can even convert it to WordStar....magic eh? Pandoc can do that...your MS Word too?
Yes, it's possible to convert Markdown to a Word file, with a variety of tools. You can use Pandoc to do this if you are the sort of person who is comfortable using tools like Pandoc. I can do that, along with all sorts of other things, because I am that sort of nerd.
However, most fiction writers and editors are not that sort of nerd. Most people don't want to use Markdown in the first place. Of the people who do want to use Markdown, not all of them are that sort of nerd, either. They want an "Export to > DOCX" command in their editor, not "save the Markdown file, open your terminal app, change to your documents directory, and type "pandoc -o my-novel.docx my-novel.md". (And that's assuming they're not doing something like, well, what NovelWriter does, saving individual chapters and perhaps even individual scenes as independent files.)
Look, I love Pandoc. It's great. But it's not a tool for everyone. If someone is trying to embrace the plain text lifestyle with a tool like NovelWriter but pointing out not being able to export to a Word file is a problem for them, asking "are you comfortable with Unix command line tools" and then telling them about Pandoc if they say yes might be a great idea -- but starting out with "obviously you hate the Unix way", maybe not so much.
> you can even convert it to WordStar....magic eh? Pandoc can do that.
No, in fact it cannot. :)
This is totally unrelated to the gist of this thread, but I just wanted to point out that novelWriter's project builder outputs to a single file, which can be markdown, ODF, PDF, HTML, and others. Pandoc could then make a single DOCX file out of that.
Your point still stands that this is too complicated for the average user, but I just wanted to mention this since it might make a difference for technically minded writers considering novelWriter.
Second...it really cant.
Shame on me, and sorry for my tone.
The Unix philosophy has nothing to do with this, since we're not talking about programming, we're talking about writing.
Has nothing todo with programming, a real hammer is better as the backside of an axe. A Specialized Knife is better then a Swiss-Pocket Knife. One tool for one job but make that job perfect.
The idea that a specialized tool is always better than a multi-tasking tool is simply not true. One must only look at the popularity and utility of leatherman multi-tools to see this to be true.
Even in programming circles, one needs only to look at how many options there are for ‘ls’ to see that “one tool for one purpose” is not always the best thing.
It is hence the name specialized, but if you have to live with a all-round tool then that whats you have.
>one needs only to look at how many options there are for ‘ls’ to see that “one tool for one purpose” is not always the best thing.
The gnu or the bsd one ;)
Until the distribution is decided my intuition is that Markdown provides this needed flexiblity.
but i could not tell from the docs how to get the end result into something like standard manuscript format without manual processing.
Since you can already export to a single ODT/PDF/MD, the benefits of additional pandoc integration are probably diminished.
Context: My partner is a published author and I've pitched stuff like this at her on multiple occasions as an alternative to Scrivener. In addition to her laughing at my insistence that markdown is a superior way to write, she cites the need for a rock solid word export option that "just works" as a requirement for any tool she uses.