Google Docs now supports some Markdown

From The Verge…

# Google Docs now supports limited Markdown. —>

Google is adding Markdown support to Google Docs on the web, letting you format your document using text shortcuts rather than keyboard ones. In a blog post announcing the feature, Google says it’s doing this through its autocorrect feature, so it will automatically format the text for you after you type it in Markdown format. For example, if you type “# Google Docs is getting more Markdown support” it’ll automatically get converted to a level one heading.

Google says that Docs already supported a few Markdown autocorrections for bulleted and numbered lists, and checkboxes. It’s adding much wider support, though — you can now use Markdown to add headings, bold and italicize text (or do both), strikethrough (though it’s done using a - on either side of your content, rather than the traditional ~), and links. That’s a far from complete implementation of Markdown, but at least it covers most of what I personally use the language for.

Markdown is extremely useful and easy to learn because of its natural syntax that doesn’t look like code.

I wrote a little bit about why I use Markdown, and how it can be used to better organize and compose content in Learning Management Software. Read that here.

While Markdown is typically used to compose text documents and web content, it will only make your experience easier if you spend most of your time inside of Google Docs.

I found some of Google’s support documentation on Markdown here.

Using Drafts and TextExpander to Organize Lesson Notes

I am moving more of my text notes to Drafts these days. You can read about how I use Drafts here. Drafts is a note-taking app where most of my text typing starts. When I am ready to act upon my text, the actions on the right side of the screen allow me to send it off to messages, emails, tasks, notes, social media, and more.

Generally, I use Drafts as a text-inbox, where I eventually process all of my text ideas and send them to other apps that are better suited for them. But lately, I wonder why I need to take the extra step of sending a draft to another app when Drafts is perfectly suited for organizing and searching text.

Let's take Lesson Notes, for example. When I teach a sectional, large ensemble, or private lesson, I like to take notes on what we played and what I assigned. Usually, I would type these in Drafts and then send the finished text to Apple Notes. But lately, I am just keeping it in Drafts and archiving it so that it doesn't clutter up the inbox area. Everything is in plaintext so searching my entire 7,000 draft library is way faster than searching Apple Notes. Plus, it reduces the amount of time I ever even need to open Apple Notes by 90 percent.

I add the tag "sectionals" to a draft where I have taken sectional notes, and I have a custom workspace that allows me to see just the drafts with that tag.

Additionally, tagging them "badge" makes it so that the draft doesn't contribute to the number on the red badge of the Drafts icon. I use the badge only to inform me of drafts that need to be processed to another app.

I write most of my drafts in Markdown, which means I use "#" symbols to note levels of the heading, "**" to indicate things I want bold, etc... If you want to read more about how I use Markdown, read this post. Drafts and common web editing tools like WordPress (and even Canvas) can turn this Markdown into HTML. I only use Markdown for my sectional notes to show bullet-pointed lists and first/second-level headings. Drafts does some light formatting to help me better see this information by, for example, highlighting the headings green.

It gets tedious to retype this template for every class, so I have TextExpander snippets to do it for me. Read about how I am using TextExpander here.

In the case of the snippet below, I type "sectionalnotes" into the body of the draft and then TextExpander prompts me for the ensemble and sectional name and then automatically fills in that data, with my fill-ins and the current date.

Using an action called Current UUID, I can copy a link to a draft to my clipboard and paste it in to the calendar event for whatever class, lesson, or sectional it is related to. That way, I can easily refer to it by date, using the visually friendly interface of a calendar app.

Eliminating Canvas Stress by Writing Content in Markdown

Left: A draft of a Canvas page, written in a text file on my computer. I used the Markdown syntax for headings, lists, and links. Right: What the Canvas page looks like once the text on the left is imported into the course page as HTML.

My district’s LMS of choice is Canvas, which is pretty stressful to work with. From most accounts I hear about other LMS software, Canvas is far from the worst. “You go to war with the LMS you have” I once heard.

Lately, I am writing my Canvas content in Markdown and storing it as text files on my computer.

Why?

Canvas is littered with user-hostile behaviors. Each class is a separate container. All files, pages, and assignments are quarantined, requiring multi-step procedures for sharing between courses. On top of this, the organizing tools are a mess. I am never 100 percent sure where to go. Even when I do, I have to wait for the internet to load each new thing I click on.

Instead of one file repository that all courses pull from, each class has its own separate Files area.

Canvas is equally difficult for students. All of the course pages and content are just sort of floating in space. It’s up to the teacher to link the material together meaningful, but the tools to do so are inelegant and unintuitive. My music program has resorted to a website for communicating most general information since it exposes the hierarchy of its structure to our viewers. In other words, we control where every page lives, and our students can get to any part of our site from the navigation bar at the top of the page.

The WYSIWYG web editors you see within most Canvas pages, assignments, and announcements are equally frustrating. They are clunky, the text field is tiny, the buttons for all the tools are ambiguous, and I lose my data if the page refreshes itself or I lose connection. Additionally, it’s hard to anticipate what my formatting will look like before actually clicking the save button.

Lately, I am writing my Canvas content in Markdown and storing it as text files on my computer. By editing in Markdown, I can create content in third-party apps, work with data offline, control where files are organized, search them from the Spotlight, and quickly export as HTML for input into the Canvas HTML editor when I am ready to publish.

Using Mac and iOS Native Apps

I like native applications because the good ones feel designed to look like the computing platform. For example, the forScore app on iOS uses similar navigation buttons and fonts to Apple’s own Mail, Keynote, Pages, and Notes. This way, I don’t feel like I am learning new software.

Native apps that deal with documents store files on my hard drive. I can easily organize them into my own folder system, work on them without an internet connection, open the same file in different applications, and search them from the Spotlight. Document-based apps update your file as you edit your data. Websites often lose your data when they run into issues.

I don’t write anything longer than a sentence or two into the text field of a website. Instead, I draft them inDrafts and move my work to iAWriter for longer projects. Both of these apps can preview Markdown.

What is Markdown?

Markdown is a shorthand syntax for HTML. It empowers me to draft web content without actually writing code. Skim this Markdown syntax guide to see what I mean. You can learn the basics in five minutes.

Drafts and iA Writer have one-button shortcuts to convert Markdown to formatted text or HTML. Here is an example of Markdown, and what it would look like once converted to rich text or HTML.

# Blog Post Title
Here are *three things* I want to do today.
1. Work out
2. Sit in the hot tub
3. Grill some chicken

Let me tell you more about them.

## Work out
Today I will work out on my bike. My wife once said, and I quote:
> The earlier in the day you aim to do it, the more likely it is to happen.

## Sit in the hot tub
This will be relaxing. Maybe I will listen to a podcast there. Here are some recent favorites...
- Sound Expertise
- Sticky Notes
- Upgrade

My favorite podcast player is [Overcast](https://overcast.fm).

Once an app like Drafts or iA Writer converts the Markdown to rich text, it would look like this:

A good Markdown app like iA Writer will convert the syntax to rich text for you and copy it so that you can paste it into an application like Google Docs, Microsoft Word, or your website.

I could have just as easily exported the resulting rich text to a Word document or Google Doc and all of the formatting would have been properly executed.

iAWriter can also export my Markdown as HTML like this:

<h1>Blog Post Title</h1>

<p>Here are <em>three things</em> I want to do today.</p>

<ol>
<li>Work out</li>
<li>Sit in the hot tub</li>
<li>Grill some chicken</li>
</ol>

<p>Let me tell you more about them.</p>

<h2>Work out</h2>

<p>Today I will workout on my bike. My wife once said, and I quote:</p>

<blockquote>
<p>The earlier in the day you aim to do it, the more likely it is to happen.</p>
</blockquote>

<h2>Sit in the hot tub</h2>

<p>This will be relaxing. Maybe I will listen to a podcast there. Here are some recent favorites...</p>

<ul>
<li>Sound Expertise</li>
<li>Sticky Notes</li>
<li>Upgrade</li>
</ul>

<p>My favorite podcast player is <a href="https://overcast.fm">Overcast</a>.</p>

Because Markdown can be converted to HTML automatically, I have found it less stressful to actually write my Canvas pages, announcements, and messages to parents in Markdown and then pasting the resulting HTML into the HTML editor of Canvas. I store my Markdown files in a folder of text files, with subfolders for each course. I have favorited these folders so that they are always accessible in the iA Writer sidebar. These folders are easily accessible. Because I am writing in plaintext, the result feels much more like writing in a simple note app than it does a word processor.

iA Writer links to folders of text files on your hard drive. But it looks like a simple note app.

Here is an example of a Canvas announcement intended to be shared with one of my band classes early this fall. It contains an embedded Google Form families sign as an agreement to our policies. Markdown and HTML can be written in the same document and iA Writer treats it all as HTML when you export it.

I got the HTML embed straight from the Share menu of the Google Form setup. I didn't need to know any code to make this message!

On the left: a Markdown document that contains HTML code for a Google Form embed. On the right: pasting that as HTML into the HTML editor in Canvas.

How the resulting announcement appears to students.

EDIT: When I wrote this post, I fogtot to add one benefit to having all of these files on your computer… even though Canvas messages don’t support formatting like headings and bold, I draft those in iAWriter too. It is SO much easier to find and re-use old emails I have sent to parents when they are searchable from my computer. Have you ever tried to search your Canvas ‘Sent’ folder? It’s terrible! Local computer copies for the win!