News for hackers. Stuff that matters.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vikingcaffiene on Tuesday January 19, 2021 @11:24AM (#25835033)
This has no word export option (unless I missed it) which makes it infeasible for a lot of writers. Like it or not, docx is the format a lot of folks in mainstream publishing expect.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @11:28AM (#25835089)
Just to add here, the question is not “is markdown (or tex or binary strings or...) better”, but “can the person who determines whether I get paid open the file?”

The fiction publishing world is cutthroat competitive. Trying to use nonstandard tools / “breaking the mold” adds even more friction to success.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by eslaught on Tuesday January 19, 2021 @02:43PM (#25837857)
I will find out the answer to this question hopefully later this year. :-)

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @03:31PM (#25838498)
I agree, and I draft my own fiction in emacs. The cost is lower to use my preferred editor, then do the post-hoc formatting adjustments once in Word.

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!

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by eslaught on Tuesday January 19, 2021 @07:17PM (#25840898)
Unrelated, but what do you write? (Feel free to contact me on Keybase if you prefer, username is in profile.)
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by onlyrealcuzzo on Tuesday January 19, 2021 @01:29PM (#25836798)
I'm an author and an software engineer. I can see why Markdown could be slightly better for a writer - but not much better - and honestly it seems like a step down for an editor.

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?

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by socialdemocrat on Tuesday January 19, 2021 @03:09PM (#25838208)
You just sold everyone on markdown. This is the whole point. All the crap MS Word adds to support formatting and visual styles is in the way. With markdown you focus on the actual text. Exactly what an author should want to.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by spicybright on Tuesday January 19, 2021 @06:02PM (#25840142)
A table of contents you don't have to manually maintain. Built-in interface to insert special characters you can't type with the keyboard. Automatic grammar checks. Auto-corrections. Macros. All of the above in one program instead of a hodge-podge of programs. Being able to send and receive documents from people with no conversion needed.

No offense but you don't sound like someone who writes a lot?

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by chipotle_coyote on Tuesday January 19, 2021 @06:48PM (#25840613)
"What does MS Word offer over Markdown" isn't a good question, because they're not the same thing -- Word is a program and Markdown is a file type. There's nothing that stops a Markdown-based editor from having a full set of features. I've very rarely felt that I was missing out on features when using iA Writer or Ulysses compared to a word processor, although occasionally I wished for either the kind of document juggling that Scrivener is so good at or actual full-blown text editor features like BBEdit. But I haven't reached for an old school word processor as my first choice as a composition tool in... probably 15 years. And I definitely do write 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. :)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vidarh on Wednesday January 20, 2021 @01:08PM (#25849730)
Writing a table of contents is my formatters job, not mine. It takes place after both my editor and my proofreader have completed their jobs, at which point I don't touch the file any more. If you format your own, then you're already in an small niche.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by eslaught on Tuesday January 19, 2021 @06:34PM (#25840464)
* Table of contents: solved by Pandoc.

* 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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by chipotle_coyote on Tuesday January 19, 2021 @06:57PM (#25840706)
The "inserting special characters" one is a bit of a "eh?" for most of us Mac users, I think, since most special characters can be typed using the Option key and the character chooser (which is indeed not very convenient!) is system-wide and should work in a native build of at least the GUI version of Emacs. But, yep -- Markdown and Word aren't the same categories of things. How comfortable your Markdown editing experience is depends on how comfortable your Markdown editor is.

(Also, I wrote a Markdown-to-ePub script, too! Although I don't think anything I've got up online uses it anymore.)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by masukomi on Wednesday January 20, 2021 @12:01PM (#25848817)
pandoc, emacs, and scripting are _not_ a realistic option for most writers. They're writers, not programming geeks.

I'm a Markdown fan, but really there _are_ better solutions for book writing that maintain the ease that Markdown brings. Things like ASCIIDoc.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @06:40PM (#25840518)
And in emacs, you can insert essentially any Unicode character with `C-x 8 RET`...add swiper and you're off to the races :)

Also, if emacs was good enough for Neal Stephenson, I'm sold...though I hear he uses Scrivener now!

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by citizenkeen on Tuesday January 19, 2021 @05:35PM (#25839851)
Why would I want to write my first draft in a different tool than my subsequent drafts? Nobody cares about visual styles, but my editor sends back their thoughts with inline edits and comments in Word. It's so much easier to edit in Word. I'm a huge Markdown fan, but it raises the question:

What does Markdown get me that makes it worth switching to for the first draft only?

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vidarh on Wednesday January 20, 2021 @01:16PM (#25849832)
Many writers intentionally separate tooling to force workflows, even at the point of great inconvenience if it provides for an environment they feel is more conducive to writing. This is generally far more important than whether or not getting it into a format that editors can work with is extra effort or not.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by em-bee on Wednesday January 20, 2021 @06:00AM (#25844932)
i am probably the wrong person to respond because the reason i prefer a plain text editor is that that's what i have been using for all my work until now.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @05:49PM (#25840002)
From your parent's comment, I think this is the key statement:

> 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!

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by thotsBgone on Tuesday January 19, 2021 @07:06PM (#25840796)
MS Word does add word processing. E.g. your straight quotes will be contextually converted to the correct left/right quote, your hyphens can become em-dashes, etc.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @01:41PM (#25836933)
Ha! This is a really interesting perspective—I think you're saying, "it's all plain text, so there's no advantage to using Markdown instead of docx".

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by eslaught on Tuesday January 19, 2021 @02:51PM (#25837955)
The benefit is the rest of the pure text toolchain. Like being able to use Git. I can confirm, for example, how long a typo has existed in my book by looking at the Git history. Maybe that's a bit academic, but you get the point. I have the complete history of everything I've ever written.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @03:40PM (#25838587)
Well, to be fair, MS Word maintains a full history of every edit that was made.

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!)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by eslaught on Tuesday January 19, 2021 @06:18PM (#25840318)
I think version history doesn't work the way you think. It seems to be supported when you use Microsoft's cloud storage product (which I do not use):

> 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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @06:24PM (#25840370)
Well said! Though, I would say that this statement is a good description of git, too:

> 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

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by aeroevan on Tuesday January 19, 2021 @03:57PM (#25838788)
> MS Word maintains a full history of every edit that was made

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?

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @05:02PM (#25839507)
I don't use Word so I can't say!

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...

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by wyclif on Tuesday January 19, 2021 @03:28PM (#25838459)
I write books in Vim. The way I work is that I do it all in plaintext until the final edit. Only after that do I add formatting (could be .docx or Markdown or whatever the editor expects).
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @05:16PM (#25839646)
What happens when your editor requests changes? How are those edits communicated to you, and how do you integrate them back into plaintext?

(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)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by wyclif on Tuesday January 19, 2021 @08:00PM (#25841252)
All edits in plaintext on both sides until the final draft. Yes, I know this isn't the standard way of doing things but it isn't so much because I'm a Vim cultist or anything. It's only because I can yank, insert, and navigate the text so much faster than with something like Pages, MS Word, or Scrivener.

Another way that seems to work well for some writers and editors is a shared Google Doc.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by TeaDrunk on Tuesday January 19, 2021 @05:45PM (#25839959)
This sounds silly but as an author myself it's extremely important that I know what the story looks like to a final reader while I write it. It's like dogfooding my own prose. Too many short paragraphs, or too many long ones, or strange gaps, etc. are much more evident to me in docx or scrivener or any other text processor.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by bjoli on Wednesday January 20, 2021 @12:38PM (#25849316)
My favourite talk on this topic is "Emacs for writers": https://youtu.be/FtieBc3KptU

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by SamuelAdams on Tuesday January 19, 2021 @05:46PM (#25839961)
Consider a book like The Lord of the Rings. It has gone through countless revisions and corrections. With markdown and git you could track those changes and corrections over time.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @05:53PM (#25840044)
Yes, you or I could...but Tolkien was much busier writing and world-building, and I seriously doubt George Allen & Unwin (the publishers) would have acceded to conditions on how the manuscript was sent to them!
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by onlyrealcuzzo on Wednesday January 20, 2021 @03:16PM (#25851382)
Also - doesn't MS Word have revision history?
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by socialdemocrat on Tuesday January 19, 2021 @03:02PM (#25838109)
Geez 99.99% of a Nobel is just plain text. MS Word adds no value. Getting plain text into MS Word is not rocket science.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by WorldMaker on Tuesday January 19, 2021 @03:28PM (#25838456)
> MS Word adds no value.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vikingcaffiene on Tuesday January 19, 2021 @03:18PM (#25838325)
I'll tell her to let her editor know that. Lol.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by lhenk on Tuesday January 19, 2021 @12:18PM (#25835787)
This can be accomplished by exporting to PDF
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by barkingcat on Tuesday January 19, 2021 @12:40PM (#25836129)
exporting to pdf is exactly what you don't want as an editor receiving files from a writer.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vidarh on Tuesday January 19, 2021 @12:21PM (#25835834)
Unless you're already a big-name author you rarely get to choose. Docx will generally be an option, and if you're lucky a few other formats.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by TeaDrunk on Tuesday January 19, 2021 @12:37PM (#25836064)
How is a copyeditor supposed to manage a PDF? PDFs are generally a huge no-no in submissions. (Source: I write short fiction & my short fiction has been published.)
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by ASalazarMX on Tuesday January 19, 2021 @12:27PM (#25835934)
I guess their editor can just cut and paste to Word if he really wants to make corrections.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by FalconSensei on Tuesday January 19, 2021 @09:03PM (#25841709)
> their editor can just cut and paste to Word if he really wants to make corrections

Is it sarcasm? I mean... make corrections/changes is what an editor does.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by ASalazarMX on Tuesday January 19, 2021 @09:30PM (#25841895)
Hes, it was sarcasm. A write-only format is the worst way to send a novel to a publisher/editor.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by spoiler on Tuesday January 19, 2021 @01:34PM (#25836863)
From the documentation:

> 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...

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vikingcaffiene on Tuesday January 19, 2021 @11:32PM (#25842604)
If she sends ODT to her publisher or editor, they will laugh at her and throw it in the trash. There are very specific rules about this stuff and no wiggle room for interpretation. It _has_ to be in docx format or it's not getting read.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by coliveira on Tuesday January 19, 2021 @12:30PM (#25835976)
She's correct. Only a programmer may entertain the idea that editing markdown is superior to any visual editor.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by lhorie on Tuesday January 19, 2021 @02:03PM (#25837278)
> markdown is a superior way to write

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by ajarmst on Tuesday January 19, 2021 @02:10PM (#25837400)
I think that House of Leaves can be left as an unaddressed edge-case for most novel-writing tools.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by rtpg on Tuesday January 19, 2021 @07:19PM (#25840910)
Even ignoring diagrams, etc, there's a reason that like word processing applications are killer apps for personal computing. WYSIWYG is a pretty convincing abstraction!

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by socialdemocrat on Tuesday January 19, 2021 @03:14PM (#25838281)
Coming up with the text and doing the visual layout later are often separate step. And author does not do all the visual layout.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by edwinyzh on Tuesday January 19, 2021 @11:59AM (#25835487)
Yes, almost publishers accept Word documents only, and that's why I've built DocxManager (https://docxmanager.com/) on top of Microsoft Word. ;)

Basically, it's an outliner/corkboard/project manager for all kinds writers who uses Word.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by falcolas on Tuesday January 19, 2021 @12:29PM (#25835954)
Windows only. Bummer. Completely understandable, but bummer. A lot of tools can output .docx files.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by barkingcat on Tuesday January 19, 2021 @12:06PM (#25835623)
I agree with her - markdown is totally not a superior way to write. It's a good way to mark up text, but writing isn't just marking up text.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by socialdemocrat on Tuesday January 19, 2021 @02:55PM (#25838006)
When writing you want a tool focused specifically on writing an organizing text. Programs like word is too focused on formatting and visual aspects.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by evolve2k on Tuesday January 19, 2021 @12:16PM (#25835771)
Acknowledge having an inbuilt export would be preferable but for what it’s worth; If you’re a dev it shouldn’t be too hard to leverage pandoc, especially coming from a clean text based format.

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...

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by TeaDrunk on Tuesday January 19, 2021 @12:38PM (#25836086)
This is now significantly more steps than downloading Scrivener.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by youngtaff on Tuesday January 19, 2021 @05:26PM (#25839757)
Unless it's got better Scrivener is pretty awful though - bought it for my first book and gave up, both books I've written were written with other tools
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by dbspin on Tuesday January 19, 2021 @07:46PM (#25841154)
Interesting, I've written two novels and over a dozen radio drama series in Scrivener. Currently using it to finish first draft on a spec film script. It's pretty fantastic. Interested to hear why it didn't work for you - especially if the alternative is 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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by sien on Tuesday January 19, 2021 @05:33PM (#25839836)
What did you use instead?
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by youngtaff on Wednesday January 20, 2021 @03:56AM (#25844138)
One was in asciidoc (the publisher's tool of choice), the other was in pages (only a 10,000 word book)

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

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by codetrotter on Tuesday January 19, 2021 @12:51PM (#25836318)
However, since NovelWriter is GPLv3 licensed, they could in theory incorporate code from Pandoc, which is GPLv2 licensed, directly into NovelWriter.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by gabereiser on Tuesday January 19, 2021 @01:24PM (#25836735)
I think you guys are missing the point. The point isn’t “how do we get from markdown to docx” but rather “why doesn’t this tool support the format my publisher expects”. Yes, pandoc is amazing, but the product needs to support exporting to docx for the publisher so that the user of NovelWriter feels supported and empowered to write.

TeaDrunk said it best: it’s now significantly more steps the user shouldn’t have to do.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vikingcaffiene on Tuesday January 19, 2021 @11:34PM (#25842617)
This is the correct take. If it's so easy to do then there should be a button or menu option that does it.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by codetrotter on Wednesday January 20, 2021 @02:35AM (#25843581)
That’s what I am saying. Integrate Pandoc into NovelWriter so that users can export directly to docx.

You and parent commenter seem to think that you are disagreeing with what I said but we are agreeing.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by mb2100 on Wednesday January 20, 2021 @05:35AM (#25844776)
or just use PanWriter: https://panwriter.com/
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vidarh on Tuesday January 19, 2021 @11:50AM (#25835360)
It can export to ODT or HTML, both of which can be imported into word, or moved over by crudely cut and pasting into Word.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by boplicity on Tuesday January 19, 2021 @03:26PM (#25838426)
You also need a way to import changes from edits. Word's track changes feature is vital in professional contexts, even though it is not always intuitive. Once a manuscript gets to the editing stage, tracking revisions, comments, suggestions, etc is extremely important. I suppose at that stage, you could just move away from a tool like this, and just use Word, or Google Docs.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by notjustanymike on Tuesday January 19, 2021 @11:43AM (#25835265)
Trying to unseat Scrivener is like competing with IntelliJ.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by mmastrac on Tuesday January 19, 2021 @11:59AM (#25835490)
Ok, we're going down the hole of analogies a little too far but VS Code and the world of language services is a pretty decent replacement for a lot of use cases outside of IntelliJ's core Java strength.

Every top dog eventually gets cut down by _someone_ over time.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by TeaDrunk on Tuesday January 19, 2021 @12:41PM (#25836146)
Scrivener does in fact have competition. (Highland 2 for screenwriting for example.)
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by pattrn on Tuesday January 19, 2021 @10:28PM (#25842279)
As a competitor to Scrivener, I'd love to know why you think that.

(I just deleted a paragraph of text so that I don't influence your response with my own opinions.)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by kadrian12 on Tuesday January 19, 2021 @11:45AM (#25835298)
I applaud the author for keeping everything text file based.

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".

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by ordinaryradical on Tuesday January 19, 2021 @11:56AM (#25835448)
None of this matters because the industry relies on docx (and it's a crusty, oldschool industry so good luck changing that).

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by falcolas on Tuesday January 19, 2021 @12:32PM (#25836000)
If we're being fair, docx (or rather, tools that write docx files) offers a lot of tooling out of the box that is useful for proofreaders, editors, and typesetters. Revision history, suggestions, and non-printing comments are all incredibly useful.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by vikingcaffiene on Tuesday January 19, 2021 @11:23PM (#25842567)
This is correct. Any writing software that aims for an audience larger than HN needs to have a very robust docx export capability.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by youngtaff on Tuesday January 19, 2021 @05:27PM (#25839770)
Depends on what industry… O'Reilly relies on Asciidoc
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by nix23 on Tuesday January 19, 2021 @12:35PM (#25836038)
I see you hate the Unix philosophy....for conversions use pandoc. A Song of Ice and Fire was not written with Word.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by chipotle_coyote on Tuesday January 19, 2021 @12:55PM (#25836373)
> A Song of Ice and Fire was not written with Word.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by nix23 on Tuesday January 19, 2021 @02:08PM (#25837365)
The output is md....dont you think you can convert that too let's say docx? You don't even have to be Google todo that.

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?

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by chipotle_coyote on Tuesday January 19, 2021 @03:59PM (#25838813)
You're missing the point that people are trying to make here.

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. :)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by spijdar on Tuesday January 19, 2021 @05:00PM (#25839485)
> (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.)

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by chipotle_coyote on Tuesday January 19, 2021 @05:24PM (#25839730)
That makes sense (I figured novelWriter did that, since it looks an awful lot like an attempt at a Markdown-based answer to Scrivener and that's how Scrivener's "Compile" function works), and I suspect it won't be too difficult for novelWriter to add other file formats to its exporter. So not being able to output DOCX is probably not a long-term issue, unless the maintainers have a philosophical objection to it. :)
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by nix23 on Tuesday January 19, 2021 @04:40PM (#25839251)
First, your probably right and i may/really have missed the point.

Second...it really cant.

Shame on me, and sorry for my tone.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by rusticpenn on Tuesday January 19, 2021 @05:08PM (#25839578)
How are you going to handle editor comments without losing history?
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by falcolas on Tuesday January 19, 2021 @01:03PM (#25836473)
When you too can afford to pay your editors, proofreaders, and publishers to accommodate your unique file formats and the associated changes to their workflow, you too can write in WordStar.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by nix23 on Tuesday January 19, 2021 @02:12PM (#25837424)
Since you obvious don't know what unix philosophy is, it's a md writer..that's it, you want to convert it..take a converter like pandoc. If you really think every writing program should have it's own converters..well then you end up with less interchangeable stuff. One tool for Writing another one for conversion..is that so complicated?
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by falcolas on Tuesday January 19, 2021 @02:59PM (#25838059)
For a layman, err, editor? Absolutely. It's a completely different workflow than what they're used to.

The Unix philosophy has nothing to do with this, since we're not talking about programming, we're talking about writing.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by nix23 on Tuesday January 19, 2021 @04:43PM (#25839293)
>since we're not talking about programming

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by falcolas on Tuesday January 19, 2021 @07:02PM (#25840754)
Ever see a framer’s axe? It’s one part axe, one part hammer. It’s perfect for framers - they love it. It’s one tool which lets them chop, modify, remove nails, hammer in nails, whatever they need to do, without having to carry 4-5 different tools.

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.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by nix23 on Tuesday January 19, 2021 @07:28PM (#25841011)
>The idea that a specialized tool is always better than a multi-tasking tool is simply not true.

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 ;)

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by CJefferson on Tuesday January 19, 2021 @05:32PM (#25839827)
If you have an editor, you need two way communication -- they are going to make changes in your word document, using track changes, so you also need to be able to convert back.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by michaericalribo on Tuesday January 19, 2021 @02:32PM (#25837740)
To be fair, docx is non-proprietary. And as an ISO standard, it is a very standard format.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by kevincox on Tuesday January 19, 2021 @11:39AM (#25835213)
Infeasible is maybe a stretch. However you will need to have a multi-step "Export for Publish" workflow which is definitely a hurdle. However assuming that 95% of the time is spent writing it may be worth it if you like the tool.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by zikzak on Tuesday January 19, 2021 @09:16PM (#25841795)
The hardest part of writing a novel is definitely not converting it to docx. I can't even express how crazy this discussion sounds. It's like people who post on writer's forums about how they have an idea for a novel and ask what the best way to get it published is.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by madsbuch on Tuesday January 19, 2021 @12:55PM (#25836368)
Docx might be an appropriate format to communicate with a publisher. But to my very limited knowledge Markdown is a good choice for the initial authoring process. As it can easily be converted. These days publishing happens on all sorts of platforms and the end product needs to be prepared for the press, ePub, Kindle, PDF, audiobooks, etc.

Until the distribution is decided my intuition is that Markdown provides this needed flexiblity.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by sigzero on Tuesday January 19, 2021 @04:31PM (#25839150)
Use pandoc to export or transform it (if you can).
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by em-bee on Tuesday January 19, 2021 @11:38AM (#25835208)
it says it can exporting to ODF, but without much formatting requiring additional editing after conversion. instead it recommends exporting to HTML, and then importing that into writer or word for better results.

but i could not tell from the docs how to get the end result into something like standard manuscript format without manual processing.

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by em-bee on Tuesday January 19, 2021 @12:47PM (#25836234)
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by RandomWorker on Tuesday January 19, 2021 @12:01PM (#25835522)
should be easy to implement using pandoc since the underlying code is python?
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by ziftface on Tuesday January 19, 2021 @01:49PM (#25837052)
Yeah I was surprised to see it didn't use pandoc for exports. I'm not sure why, and all these issues about exporting to word wouldn't exist.
Re:NovelWriter 1.0 – A markdown-like editor for writing novels by RandomWorker on Tuesday January 19, 2021 @04:49PM (#25839363)
Might be due the GPL license of pandoc, this is a copyleft type license, requiring any code that is built with pandoc to be described, made available, and released under the same license.

https://github.com/jgm/pandoc/blob/master/COPYRIGHT

Re:NovelWriter 1.0 – A markdown-like editor for writing novels by spijdar on Tuesday January 19, 2021 @05:05PM (#25839542)
Given that novelWriter itself is GPL licensed, I doubt this is the problem. More likely it was a choice to avoid needing pandoc as a dependency, either explicitly (bundled or integrated in the code somehow) or implicitly (calling to the system's pandoc install), as pandoc is written in Haskell and kind of a PITA to build or integrate in that way.

Since you can already export to a single ODT/PDF/MD, the benefits of additional pandoc integration are probably diminished.