Posts tagged with "markdown"

Marked Released On Mac App Store, Discounted, and Updated

Marked, developed by Brett Terpstra, is my must-have utility to convert MultiMarkdown to HTML on my Mac. Whenever I need to publish an article from OS X rather than my iPad (usually because I need to record and include GIFs or screencasts), I rely on Marked to handle conversion to valid HTML with a keyboard shortcut. And yet, as we've shown before, there is so much that Marked can do, such as printing to a variety of formats, keyword and readability analysis, and more.

Today, Brett released version 2.3 of Marked and made it available on the Mac App Store as well. Both versions of the app share the same features and they are both sandboxed to comply with Apple's App Store rules. However, in spite of the restrictions, Marked hasn't lost its functionality – instead, Brett managed to add new options such as full GitHub Flavored Markdown support, improved PDF export stability, a document reading progress bar (I love this), and a mini map for navigation with fast scrolling.

What I still find most impressive about Marked isn't its feature set per se, but rather how the app can be used as a simple tool for short posts or an advanced solution for writers who are working on a book or long documents. Marked is incredibly powerful and flexible and, at $9.99 on the Mac App Store as a limited time sale, I highly recommend it.

(Check out Brett's blog post and our previous coverage of Marked.)

Permalink

MindNode 3.1 Adds Redesigned Outline, Markdown Export

MindNode is an elegant and powerful mindmapping app that I use on all my devices to visualize thoughts and topics before writing an article or preparing research for a podcast episode. I've been a fan of MindNode for years, and I was particularly impressed with version 3.0, which brought a new iOS 7 design alongside more intuitive interactions, better iCloud sync, and keyboard shortcuts.

Today's 3.1 update, available on the App Store, features an entirely new sidebar for your mindmap outline that replaces the app's old popover. The advantage of the sidebar approach is immediately clear on the iPad, and especially in landscape mode: with the new version, you can keep the map and sidebar open at the same time, tapping on items in the outline to select the respective node on the map (and vice versa).

Read more


Editorial 1.1: Another Step Forward for iOS Automation

Editorial, Ole Zorn's text automation tool and Markdown editor for iOS, has changed the way I work on my iPad.

Combining an elegant text editing experience with a powerful workflow system based on actions and a built-in Python interpreter, Editorial reinvented iOS automation and explored new horizons of what could be achieved with inter-app comunication on an iPad. Editorial can be just a text editor, but its true potential and versatility are revealed by an Automator-inspired interface that is the foundation for workflows to automate text editing, web services, image manipulation, and more -- all on an iPad, without needing a Mac. Editorial sits at the forefront of the post-PC era, and it's become an indispensable tool for my professional life.

Editorial came out on August 15, 2013. Over the past nine months, I've seen Editorial go from a minor 1.0.1 release to a feature-packed, redesigned 1.1 that feels like a 2.0 update -- the kind of deep, fundamentally different version of an app that several developers would charge for as a separate product on the App Store.

It's undeniable that Zorn should have released an update with fixes and basic iOS 7 compatibility sooner, but it's important to note that Editorial 1.0 (aside from minor issues) kept working well on iOS 7, and Zorn documented the development process with notes and screenshots on the app's forums. As an Editorial user and reviewer, it's been a long journey from version 1.0 in August 2013 to today's 1.1 release, but it's been worth it.

Editorial 1.1 brings a plethora of design changes, Markdown improvements, and automation breakthroughs that, just ahead of iOS 8, represent a major milestone for Markdown text editors and iOS automation. Editorial 1.1 may be a text editor on the surface, but, in reality, it's a small revolution for iOS power users.

Read more


The Markdown Payoff

Hilton Lipschitz, writing about switching to Markdown and whether it paid off:

The key to Markdown writing is that you focus on the content. Structure, format, look and feel are all secondary. It’s pure distraction-free writing. Which means that you have no choice but to write and think about writing and focus on the content. Which encourages you to become a better writer.

For me, Markdown has singlehandedly revolutionized the way I can put together articles for MacStories without wasting hours over HTML and RTF issues.

I used to write in the WYSIWYG editor of WordPress, which meant that I often ended up with strange formatting in my posts and I didn't have any local copies of my files because there were no files. If the browser tab crashed and I hadn't saved a draft, the post was gone and I had to start over from scratch. I didn't want to use Word for Mac and pasting from Pages created even more issues with formatting in WordPress (we are talking about 2009-2010 WordPress), so I stuck with writing in the browser. And it was terrible.

Since I switched to Markdown in late 2012, I have generated an archive of over 600 plain text files that are fully searchable, indexed by Spotlight and Dropbox, and readable by any operating system. Thanks to plain text, my articles and notes are portable and I can switch text editors whenever I want. When I convert to HTML and I see that everything looks good, I get a geeky serotonin kick that reminds why I will never write in the WordPress editor again.

Markdown and related services1 make it easy to add links, formatting, tables, footnotes and to generate HTML with a wide array of settings and options; because of that simplicity I have written more, fixed more typos, and generally dealt with more readable files. Markdown didn't merely pay off – I don't know how I'd go back to any other format at this point. It's just natural.

Tools may not make me a better writer, but Markdown allowed me to ignore the bureaucracy of web publishing, enabling me to write complete articles from anywhere. I'm thankful that it exists.

Permalink

Matching URLs In Editorial with John Gruber’s Regex Pattern

Editorial for iPad

Editorial for iPad

When I'm writing in Editorial, I often need to make sure I'm dealing with a valid URL in the system clipboard, the document editor, or in a variable. To do so, I've long employed John Gruber's liberal, accurate regex pattern for matching URLs, which has reliably allowed me to confirm that a workflow is about to handle a proper URL rather than a string of text that contains something else. Gruber recently improved the regex pattern again, and that seemed like a good opportunity to briefly detail how I've integrated his pattern in my workflows.

The key to match URLs and provide error-handling features in Editorial is to use a conditional block based on a regular expression pattern. Editorial comes with this functionality built-in: given a regex pattern, a block of actions can be run only if a value (plain text or variable) matches the pattern. In this way, you can run a set of actions if you have a URL, and another set if you don't have a valid URL.

I've created a simple workflow that can be installed and reused as a preset in other workflows. The workflow, called Match and Open URL, consists of a single If block that checks for a URL contained in the clipboard. If you have a URL that matches Gruber's pattern, the URL will be extracted from the clipboard and launched in the browser; if you don't have a URL…it's up to you to provide an alternative.

Editorial makes it extremely easy to build this kind of advanced workflow with just a few built-in actions. Gruber's single-line version of the regex pattern can be pasted in Editorial's If action with no modifications; inside the If block, the text in the clipboard is passed to a Find action that extracts a URL using the same, untouched single-line regex pattern. The extracted URL is opened in the browser and a HUD alert is displayed.

Combining Gruber's regex pattern and Editorial's workflow system can yield interesting results. You could use a variable instead of the system clipboard to match URLs; you could implement the pattern in a Repeat block that performs a set of actions for every matched URL found in the target text; instead of having my workflow inside an If block, you could match a URL among other bits of text, extract it, and do something with it. Editorial is a text automation playground and your imagination's the limit.

You can download the workflow on Editorial Workflows' website, and check out John Gruber's regex pattern here.

Note: The screenshot above shows a beta version of Editorial, currently in testing.



MultiMarkdown 4.5

Fletcher Penney released version 4.5 of MultiMarkdown today, which brings several improvements and some great new features. MultiMarkdown has become the standard for many of the best text editors on iOS and OS X, and Fletcher is constantly updating it (alongside his app, MultiMardown Composer) to keep up with the times.

The new version comes with support for what he calls “File Transclusion”. MultiMarkdown can now include the contents of a file inside another file – think of document hyperlinks, done in plain text. From the docs:

Transclusion is recursive, so the file being inserted will be scanned to see if it references any other files.

Metadata in the file being inserted will be ignored. This means that the file can contain certain metadata when viewed alone that will not be included when the file is transcluded by another file.

This is a powerful addition for writers who have been looking for an easy way to reference files and group their contents together – now Transclusion happens directly before the processing step, with MMD taking care of scanning files and even additional links within those files. The obvious implementation would be to write a book or academic paper in plain text, keeping chapters as separate files in a folder and referencing their file names in the Table of Contents. There are many possibilities and I can't wait to see this being included in some iOS text editors.

You can download the latest MultiMarkdown here.

Permalink

Insert Markdown Image Links Interactively with Editorial

Stefan Wolfrum:

Because the markdown documents I write contain usually a few images from web sites I research (not from my iPad image library) and because Editorial includes its own web browser I asked myself: why can’t I just somehow insert a markdown image link in my document to an image that’s on the web page I see in Editorial’s browser? Either I’m missing something or it just isn’t there (yet). Well, because I’m always eager to learn I started to implement exactly that.

One of the most clever workflows I've seen in a while. I'm using a similar trick in my Feed Wrangler workflows, and Stefan's idea can be easily repurposed for other scenarios. Well done.

Permalink

Marked 2 Tips for Long-Form Reading

Brett Terpstra:

Marked 2 is great for live previews while you write Markdown, but it’s also very handy for reading long form articles. There are a variety of themes and many features for quickly navigating through long pieces.

I use Brett's Marked when I'm writing on my Mac. With Sublime Text, it's easy to run a custom build command (preview) for Marked and I love that the app (unlike many others) supports header IDs when it converts Markdown to HTML. When I was working on my Editorial review, Marked was essential in the editing process to preview images, code blocks, and navigate through the final 25,000-word document.

Nothing beats Marked's Markdown preview tools. It turns out, it's pretty great at enhancing long-form web reading too. Who else thinks this would be fantastic on an iPad?

Permalink

Marked 2.1 Improves Word Repetition Visualization and Text Statistics

Marked 2's first point release has landed, and it's chock full of great improvements. If you haven't purchased Marked yet, think of it as fancy document preview tool that helps you catch formatting mistakes, catches overused words, and highlights cliché phrases. It's a mini-editor for your text documents, especially useful for those who write in Markdown and publish text on the web. For those who already have Marked, download the latest update to grab bug fixes and notable feature improvements such as background calculation for text statistics.

Permalink