This Week's Sponsor:

Winterfest 2024

The Festival of Artisanal Software

Posts tagged with "markdown"

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

Marked 2 Review

One of the most indispensable pieces of software currently on my Mac is Marked. Paired with TextEdit, I write in plain text and format words in Markdown, letting Marked transform working documents into live previews complete with clickable links and footnotes. At the end of my session, I can convert everything into HTML that I can copy and paste into WordPress. It’s a brilliant little tool that I don’t utilize the full capabilities of, but it makes my life significantly easier when it comes to just writing stuff. For most writers, these few features alone are enough.

For writers willing to put in the work, Marked can display previews that match your website’s style and theme by creating a custom CSS template. There’s handy keyboard shortcuts, like Command-U for viewing source code and Shift-Command-C for saving HTML to the clipboard. You’ll additionally find things like a viewable table of contents built in that let you jump to specific sections for documents with multiple headings. Plus, Marked happily works with the text editor you’re already using.

Yet there’s so much more underneath the hood. For screenwriters, Marked works with apps like Scrivener and markup languages like Fountain. Those who have to write and publish formulas can do so with MathJax. And old Markdown hands can specify their own custom processors… something that’s possibly over my head. Marked is a labor of love, catering to geeks while remaining accessible for writers like me who want easy previews and invaluable features like the ability to process Markdown within source code.

Considering all that Marked already does, Marked 2 is a huge release that adds a ton of new features for editor, bloggers, and people who would rather write in Markdown than open Microsoft Word. Instead of running through every new feature, I’d rather focus on the two that have the greatest impact on me. Keyword highlighting makes self editing much easier, while new searching features let me skip past the results I don’t need to see.

Read more