ThiefMD is great for organizing your markdown documents. With the ability to drag and drop to organize the order of your library, then export your work with a few clicks, ThiefMD can make compiling an epic story into a tiny task.

Git for Writers

ThiefMD's Live Preview Mode

We recommend using GitHub or GitLab as a way to store and backup your work. This Guide to Git and GitHub for Writers would be a good place to brush up on git if you’re not familiar with git already. D. Moonfire has a great post on how he uses GitLab to manage his writing.

While ThiefMD has been mildly tested, data loss, file sync conflicts, and good old fashion acts of God can happen. Using Git will provide peace of mind knowing you can always recover your work, or find that sentence you deleted that wasn’t “good enough” at the time.

Markdown for Writing?

Markdown isn’t just for programmers anymore. Markdown makes it easy for writers to focus and write.

With minimal effort to learn and remember, using Markdown will remove all of the hassle of learning a specific editing program, struggling with document formatting and design, and getting stuck in vendor lock-in.

ThiefMD is a Markdown Editor that lets you focus on your words.

Structuring Your Novel

We have a sample novel project on GitHub featuring the first 5 chapters of Lewis Carrol’s Alice’s Adventures in Wonderland.

We like breaking down our projects into:

/Novel
/Novel/title-page.md
/Novel/Chapter-01/Part-1.md
/Novel/Chapter-01/Part-2.md
/Novel/Chapter-01/Part-3.md
/Novel/Chapter-02/Part-X.md
/Novel/Chapter-0Y/...

where each part is a scene in our chapter.

If you wanted to, you could structure your novel like:

/Novel/title-page.md
/Novel/Chapter-01.md
/Novel/Chapter-02.md
/Novel/...

and ThiefMD would still export your work to the desired format. You could even write your entire novel in a single markdown file, and ThiefMD would still be able to produce your ePub.

Work in whatever way keeps you comfortable and helps you write. We’ll do our best to stay out of the way.

Novel Metadata

The title page contains our novel’s metadata. When using metadata, make sure to tell ThiefMD the first file in the project includes the author metadata.

The metadata in title-page.md should look something like:

---
title: My Great Novel
author: My Name
cover-image: /images/cover.png
---

During export, this will be embedded into the resulting ePub.

Export Preview Window and resulting ePub

Sharing your Work

Menu screenshot showcasing Export Preview option

Ready to share your work?

Right-click on the folder you want to publish and click Export Preview. Items will be organized the same way they’re kept in ThiefMD.

This will bring up the Publishing Preview window. Double check that everything you want is there just the way you want it.

Export Preferences Dialog

Once you’re ready, click on the Export button.

Pick a place for your great work and pick a name. Currently, ThiefMD supports PDF, DocX, ePub, HTML, MHTML, LaTeX, and Markdown export.

ThiefMD will generate the output based on the filename. my-great-work.pdf will create a PDF. my-great-work.mhtml will generate an HTML page with any images embedded into the same file. my-great-work.md will convert every single markdown file selected into a single markdown file you can share.

Things not looking quite as planned? In the Export Preferences Ctrl + , you can tweak the results based on how you organized your library.

Want more advanced control of how your book looks? Export Styles requires a little CSS know-how to get your book looking great.

Importing Existing Work

Already working on something great? If it’s a folder of Markdown files, just drag it into the Library.

Coming from DocX, OPT, HTML, or something else? Made an ePUB and lost the source Markdown? Drag the file onto an existing folder in the Library, and if ThiefMD supports it, it will convert the file to Markdown.

Files containing image assets (like DocX, OPT, or ePub) will have their images added to the library.

You’ll have to re-add your novel’s metadata, but it beats having to type the whole thing over again.

Getting in the Zone

Typewriter scrolling helps keep you centered. The current line is always in the middle of the screen.

You can keep writing without having to touch the scroll-bar to keep the cursor in your favorite position.

Ctrl + 1 will change in Editor Only mode. Eliminate distractions and focus on the current sheet on hand. Want even less distraction? F11 will enter full-screen. No title-bar, no desktop background, no distraction. F11 or Esc can help return you back to the world of noise.

Ctrl + 2 will switch to Editor + Current Folder view. Want to keep focused on a single chapter and break the chapter into multiple files? This view is for you. Drag and drop files to reorder, and quickly switch between them with just a click.

Ctrl + 3 will take you back to the Library view.

Screenshot of multiple themes for ThiefMD

Make the editor your own. We have a selection of themes available, and ThiefMD can load your favorite Ulysses themes. Find a theme that encourages you to write and get in the zone or make your own.

Writing on Multiple Devices

Have multiple devices? Git is a secure way to keep things in sync and have history, but it might not work on your mobile device1.

DropBox is useful for syncing files between mobile, laptop, and desktop devices. ThiefMD still has some issues with detecting file changes, so be careful if your plan doesn’t support file history.

ThiefMD doesn’t lock you into a specific format or editor, so you could use Ulysses on your Mac, iA Writer on your iPhone, Visual Studio Code or Typora on Windows, and markor on Android.

These are just suggestions. Markdown is plain-text, so you’re not locked in.

There’s a world of editors out there. We’re glad you choose ThiefMD to be one of yours.

Now Get Writing!

ThiefMD won’t lock you in, and now you know how to get your work out and keep things in sync.

  1. Working Copy on iOS will let you checkout a git repo on your iPhone or iPad. Ulysses or iA Writer support integration with Working Copy.