• 1. Getting Started
• 2. What’s New in MarsEdit 3?
• 3. Solutions by Topic
• 4. Questions & Answers
1. Getting Started
Setting up a blog
When you first launch MarsEdit, it will ask you for details about your blog. If you ever want to add another blog, just choose the File > New Blog… menu item.
After you enter the name of your blog and the URL of its home page, MarsEdit will usually be able to figure out the rest of the settings it needs.
If MarsEdit doesn’t auto-detect the settings, refer to the Manual Configuration page for simple instructions on configuring popular blog systems.
Downloading and browsing recent posts
If MarsEdit detected your blog settings, your most recent posts will be downloaded automatically. To manually download recent posts, click the Refresh button in the toolbar.
Note: MarsEdit asks you for your blog password, which is stored securely in the system keychain. For most blogs, the username and password are the same as you use to login to your blog from a browser. But for Movable Type blogs, the username and password for MarsEdit is different, and is called the “web services password.” You can find this password in your Movable Type user settings on the web.
When MarsEdit finishes downloading, the titles of your recent posts will appear in the table at the top of the main window. Select an item to see a preview of the full post in the bottom half of the window.
What to do if there’s an error
Refresh failures might be due to problems with your network connection, or because of a configuration problem in the blog’s settings.
The error message should include information from the blog about the cause of the failure, though these messages are not always helpful.
- Double-check that you have the correct settings for your blog. The System Name, System API, API Endpoint URL, and Blog ID fields must be correctly configured.
- Try searching the MarsEdit Forums with words from the error message. Many common configuration problems have been solved before by the MarsEdit community.
- If you’re still having trouble, feel free to contact us for assistance. We’ll be glad to help get you up and running!
A Note About Movable Type and TypePad Passwords
If you find that MarsEdit repeatedly displays the password authentication dialog, and you’re sure you’re typing it correctly, it’s possible you’re entering the wrong password for this purpose. These systems are unusual in that they require a separate, web services password when logging in from an application such as MarsEdit. To locate the password, log in to the system’s administration panel on the web, and look inside your user settings.
Brand new in MarsEdit 3
All new Rich Text editor: no HTML required!
The rich editor offers an alternative to MarsEdit’s beloved HTML text editor. While you are writing your blog posts you can style text, arrange images, create lists and more without using HTML code.
Updated HTML Editor with advanced syntax highlighting
For those who prefer straight HTML we’ve added beautiful new syntax highlighting with different colors for attributes, keywords and tag structure, to make it easy to spot syntax errors at a glance.
Support for WordPress Pages
MarsEdit now lets you download, edit, and create Page entries on WordPress blogs. Now you can manage your blog and your permanent site pages from the same comfortable interface.
Support for Custom Fields
For WordPress and other blogs that implement the WordPress API, you can configure custom fields in MarsEdit to customize the post editing interface.
Updated Media Browser with iPhoto, Aperture and Lightroom integration
Browse your media collections to find the perfect photo for your post. When you attach an image, MarsEdit lets you specify the size, name, and alternative text in one easy step.
Scheduled media attachments
With scheduled media attachments you can compose your posts with rich media even when completely offline. When you are ready to publish, the images or other media files are uploaded to your blog and inserted into the post.
What we added in MarsEdit 2.4
Improved Squarespace Support
More and more users are checking out Squarespace as a powerful, hosted blog solution. This release of MarsEdit supports added features for Squarespace including tags, server drafts, and adding new categories.
What we added in MarsEdit 2.3
Support For Tumblr Blogs
Tumblr is a popular blogging system that emphasizes simplicity of style and content. MarsEdit’s new support for the system means you can easily manage posts on your Tumblr blog right from the desktop.
Improved Media Manager Performance
We turbo-charged the Media Manager window so it opens much faster when you have lots of photos or other media in your collection. Spend less time waiting and more time posting!
Revised Technorati Tags Editor
If you like to add Technorati Tags to your posts, you’ll find the process much smoother starting in 2.3. The editor now lets you easily add or remove tags completely with the keyboard, or with the mouse if you prefer.
What we added in MarsEdit 2.2
Generic AtomPub Support
AtomPub is a new specification for communication between a blog and a remote editor such as MarsEdit. To use MarsEdit with your AtomPub-compatible blog, select “Other AtomPub Compatible” from the configuration popup in your blog settings, and enter the service document URL in the API Endpoint URL field.
Customizable Image Markup
Now you can use MarsEdit’s powerful formatting macros in the media window. In addition to the built-in macros for image alignment, you can add your own to finely tune the markup that is used when inserting images or other files.
Significant speed improvements to launch time and sorting the table of blog entries.
- Support for removing unwanted items from the media catalog.
- New post table columns for viewing Tags or Post ID.
- A date editor pull down for easily selecting today’s date.
- Improved MIME type generation for uploaded files.
- Blosxom now uses the “Slug” field to specify the file name.
What we added in MarsEdit 2.1
Search Your Drafts and Entries
Now you can quickly filter your posts and drafts by keywords. Just type a word or phrase into the toolbar search field, and MarsEdit will restrict the post listing to only items that contain the text you’ve typed.
Improved Web Preview
Performance and usability of the built-in web preview are dramatically improved, updating more quickly and without flickering or jumping around as you edit your post.
Native Tags Support
For supported systems, including Movable Type and WordPress, MarsEdit now offers a field for capsule-style tagging of your posts. It even remembers the tags you’ve typed before, so you’ll be able to reuse them in a jiffy on future posts.
Save Drafts To Server
A new Post Status popup in the options pane lets you choose between Published and Draft status, on supported systems.
What we added in MarsEdit 2
Beautifully Refined User Interface
MarsEdit 2.0 extends the simple elegance of MarsEdit 1.2, incorporating new features while continuing to simplify the user interface. Much more than just a pretty face, MarsEdit’s beauty and simplicity help you be a more productive blog author.
Seamless Flickr Integration
The streamlined Media Manager now sports a dedicated tab just for Flickr! Browse your most recent photos, or your entire collection. You can even search by tag or photo title. When you find the perfect picture, insert it into your post with the click of a button. Read more.
Powerful Formatting Macros
Nobody likes to type HTML code, which is why MarsEdit’s formatting macros are so invaluable. With the ability to transform text from the editor or the pasteboard, you’ll find it a breeze to customize macros for the most tedious of your HTML tasks. Read more.
Streamlined Post Editor
The post editor was completely rethought for MarsEdit 2.0, giving you the power to show or hide fields in the window so that only the useful elements are visible. On supported blogs, you can even add new categories, or edit the slug (short URL name) of your posts, without ever leaving MarsEdit. Read more.
New Printing Support
MarsEdit makes writing on the web a real joy, but sometimes it takes marking up a paper copy of your masterpiece to make sure you’ve gotten all the kinks out. With MarsEdit 2.0 you can print both the raw text of your post or the HTML preview, making it a snap to take your work-in-progress offline for yourself or others to review.
A gigantic number of “tiny tweaks” have been made to MarsEdit, moving it ever closer to perfection. Take a look around and see how the place suits you!
4. Questions & Answers
Why can’t I upload images to my blog? It doesn’t appear in the popup list of blogs.
Not all blog systems support image uploading. If yours doesn’t, you might consider establishing a free blog at a site like Blogger or WordPress, where image uploads are well-supported.
Note for Blogger users: MarsEdit will upload images directly to your Picasa Web Albums account, but you must sign up for Picasa before this feature will work. Once you’ve signed up with Picasa using the same gmail.com account as you used for your Blogger blog, you’ll be able to upload directly to Picasa by selecting your Blogger blog in the Images & Files dialog.
Note for MetaWeblog-compatible blogs: to support image uploading, your blog’s API must support the metaWeblog.newMediaObject method. Most blogs implement this method correctly, but a few do not.
How do I choose default settings for allowing comments, text filters, etc.?
MarsEdit supports default settings for many options, so you don’t have to set them every time you create a new post. See Setting Default Options For New Posts.
How do I edit the published date and time of a post?
Choose Post > Edit Date…
Can I use MarsEdit to publish a blog on my general-purpose site?
MarsEdit relies on other software (such as Blogger, WordPress, Movable Type, etc.) to create your blog. It does not generate or organize the HTML required for a blog, so it can’t be used to easily edit blogs directly on a site without blog-hosting software installed.
MarsEdit Menu Items
* About MarsEdit * License… * Check For Update * Preferences ⌘ , * Install Browser Bookmarklet * Services * Hide MarsEdit ⌘ H * Hide Other ^ ⌘ H * Quit MarsEdit ⌘ Q
* New Post ⌘ N * New Page ⌘ ⇧ N * New Blog ⌘ ^ N * Edit Post ⌘ O * Edit with (BBEdit) ⌘ ^ J * Close ⌘ W * Save as Local Draft ⌘ S * Revert * Page Setup * Print ⌘ P
* Undo ⌘ Z * Redo ⌘ ⇧ Z * Cut ⌘ X * Copy ⌘ C * Paste ⌘ V * Paste and Match Style ^ ⇧ ⌘ V * Paste HTML Source ^ * Delete * Select All ⌘ A * Find * Spelling * Transformations * Speech * Start Dictation fn fn * Emoji & Symbols ^ ⌘ Space
▾ Columns * * Open in Browser ⇧ ⌘ B * Show Post Options ⇧ ⌘ O * Show Preview ⇧ ⌘ P * Show Status Bar ⌘ / * * Title Field * Slug Field * Link Field * Keywords Field * Tags Field * Excerpt Field
* Add Custom Posts
* Hide Blogs ⌥ ⌘ . * Hide Toolbar * Customize Toolbar * Enter Full Screen
* Refresh ⌘ R * Refresh All ⇧ ⌘ R
* Edit Settings * Enter Password * Enter HTTP Password * Edit Preview Template * Remove
* Send to Blog ⇧ ⌘ D * Edit HTML Text ⇧ ⌘ T * Add Image or File… ⇧ ⌘ I * Add Technorati Tags… ^ ⌘ T * Edit Date… ⌥ ⌘ L * Edit Trackbacks… ^ ⌘ U * Edit Enclosure ⌥ ⌘ E * Split Post * Edit Body ⌥ ⌘ B * Edit Extended Entry ⌥ ⌘ X
* Link ⌥ ⌘ A * Paste Link ⇧ ⌘ A * Image from Link…
* Style * List * Alignment * Heading
* Paragraph * Block Quote * Preformatted * Line Break ⌘ ↩
* Minimize ⌘ * Zoom
* Main Window ⌘ 1 * Media Manager ⌘ 2 * Upload Utility ⌘ 3 * Network Log ^ ⌘ N
* Bring All to Front * MarsEdit
* Search Box * MarsEdit Help * Start a Blog…
* Contact Support * Community Forum