The Basics

Ways to publish notes

There are currently six different ways to publish and save notes in your Write.app. Write.app supports two types of notes - private notes and public notes. All notes are completely private by default with no action necessary on your part to keep them private and secure. All notes can be toggled between private and public status at any time either upon first saving and later after editing.

Saving basics

Shown here is Wreditor's note options panel. You'll find this on the right hand side of the note editor each time you write or edit a note. Here we'll go through these options one by one.

1. Notebook
The save-to-notebook dropdown menu allows you to choose which notebook to save your note in. You can change this at any point in the future. If you delete a notebook your notes from that notebook still exist and are placed in the default "My notes" notebook. Saving to notebooks allows you to filter your notes by notebook in both the note manager and your public page. To add options to this dropdown you must first create one or more new notebooks which you can do in the note manager below your list of default notebooks.

2. Post slug
You do not need to fill this out. Note slugs identify your note on public pages and apply to public notes. If you leave this field blank Write.app will create a slug for you from your note's title. If you do not give your note a title a temporary title will be created for you. Note slugs can only contain URL-friendly characters. That means no spaces or other special symbols and your slug must be converted to all lowercase. The reason for this is because the slug will be used in the URL of your note if you ever make it public. For example, a note entitled "How post slugs work" would automatically be given the slug how-post-slugs-work. If you do decide to use a custom post slug and you make a mistake, don't worry. Write.app will automatically lowercase and replace any disallowed characters with URL-friendly ones.

3. Making notes public
Public notes are discussed below. Jump to public notes .

4. Save note button
The big red Save note button saves your note to your Write.app account when you are finished. Within the Write.app website and Wreditor (the Write.app note editor) there is only one way to save a note to your account and it is this button. Please note that downloading your note as a text file (discussed next) will not save your note to your account and notes are not auto-saved on a time interval (yet).

5. Download your note
A new feature to Write.app is the ability to save notes locally to your computer. To download the contents of your note simply click the link below the big red save button that says "Download as text file". This will download what you've written to your computer as a Markdown file that can be opened in any text editor. Please note that saving to your computer will not save it in your Write.app account. You'll need to press the big red save button in addition for your note to be saved on your computer and in your Write.app account.


Text to save

Another quick way to save notes to your account is via text message. In order to activate this feature you must activate two-factor authentication which is only available to Write.app Premium subscribers (which is currently available for free for a limited time, see your account settings panel for more information). Once you've upgraded to premium several new features will appear in your account settings. In your account settings, click the Security tab. Under the "Two-factor Authentication" heading you'll find a field to save your mobile number (without spaces or dashes) and a checkbox that activates the feature. So long as your mobile number is saved you'll have access to text-to-post functionality whether or not the checkbox for two factor authentication is checked or not. Once active, all you need to do to save a note to your account via text message is send a text from the number you have saved in your account to US number 815-534-4831. There is currently no way to give your notes a title or make them public via text. However you can always log into your account online and edit your note's title and privacy options.


Save via email

Premium subscribers have the ability to save private or public notes via email. To save a note by email simply send an email to notes@post.writeapp.me for private notes or public@post.writeapp.me for public notes. You must send the email from the email address associated with your account. This can be seen and changed in your account settings under the Account Info tab. When you save a note by email the subject line becomes the title and the message body becomes the content. You can write using Markdown if you wish as well. One thing to note, however, is that any formatting or inserting of images or other attachments is not allowed. Attaching images, files, or formatting your note with your email client's built in tools in rare cases will cause an error but usually those adjustments will simply be ignored and the plain text of your message only will be saved.

Private notes via email
Private notes should be sent to notes@post.writeapp.me

Public notes via email
The email address for posting public notes is public@post.writeapp.me


Making notes public

Public notes are visible to the entire world and are not password protected in any way. You can use public notes to write a blog or publish anything you'd like to make public under your account. Public notes are available at writeapp.me/your-username-here. By adding your username to the end of the official Write.app URL (writeapp.me) you can get a listing of all notes you've made public and sorted by notebook.

In the note editor while creating a new note or editing an existing note, you'll find the option to make notes public or private as the third option just under the option for custom post slugs. When creating a new note this option is red and marked as private by default. By clicking this box you can toggle between making the note public or private. You can change this setting at any time by editing your note. To edit notes, visit the note manager by clicking the Notes link in the main navigation, find the note you'd like to edit, and click the edit button on the right hand side, next to it.


Mobile notes

Although the main Write.app website is responsive and, for the most part, works fine on most smartphone browsers, we also offer a dedicated mobile web app which is accessible at writeapp.me/mobile. This section of the site is in early beta but does allow for saving, editing, and reading of your notes. On any smartphone, simply navigate to writeapp.me/mobile, log in, and you'll be able to use Write.app from your smartphone. iPhone users can take advantage of the mobile web app features by clicking the Share button in the bottom toolbar of mobile Safari () and choosing the "Add to home screen" option. On iOS version 5 and higher you should see the Write.app icon in this window. After choosing this option, a Write.app icon will be added to your home screen for quick access to your Write.app account.

iOS Home Screen Icon
iOS icon
(the Write.app iOS icon)


Sublime Text plugin

If you know what Sublime Text is then this section is for you. If not, you're not likely to have much interest. If Sublime Text is your text editor of choice, you can save notes directly from the app into your Write.app account using our plugin. You can either manually install the plugin (which is beyond the scope of this article) or use Package Control to install and update it automatically.

Manual installation and setup

To manually install the plugin you'll need to download the source which we keep on our official GitHub account. Once downloaded, simply drop it into your Sublime Text packages folder and continue on to the next section on Setting up the plugin.

Install using Package Control

Our plugin is also available on Package Control which is far easier to manage. Press Control + Shift + P (substitute Control with Command on a Mac) to open Package control. Type "Install" and choose "Package control: Install Package". Once there, type in "Write.app" and the official Write.app plugin for Sublime Text will show up. Click it to install the plugin.

Setting up the plugin

Before you can begin saving notes from Sublime Text you'll need to enter in your Write.app account credentials. To do this, open up Sublime Text's User settings. In that file add the following code:


{
	// Some settings will probably be here - add yours at the end
    "writeapper_user": "yourUsername",
    "writeapp_pass": "yourPassword"
}

In the preceding code, replace the "yourUsername" and "yourPassword" parts with your own username and password then save the file. Once saved you can save any note open in Sublime Text to your Write.app account simply by pressing Alt+S. Please note that you must first save a copy of the file on your hard drive before you can save to your Write.app account. This requirement will be lifted in the future. You can be sure your note was saved by checking the status bar at the bottom of the Sublime Text window. It will display a message confirming your note was saved.

Full details on how to use the Sublime Plugin are coming to the help docs soon in a separate article. For now, see the official announcement for a more detailed usage guide here.

Try it now!