Every respectable software project needs a . This file provides crucial information about what the project is, how to work with it, and other relevant information for developers. files are written in , a special markup syntax. The syntax for markdown is simple enough, but it can be a pain to manually type out, and it’s easy to make simple mistakes and typos. README README markdown Wouldn’t you like to just use the keyboard shortcut to bold some text instead of typing around your text? Or what about creating a nicely formatted table in your , especially when editing an existing table? Wouldn’t it be nice if the table formatting and column width adjustments were taken care of for us? Markdown is wonderful, but it’s not exactly as easy as working with a Google doc when applying formatting. Cmd+B ** README The is here to help! SFDocs Markdown Assistant VS Code extension Common Use Cases In this article, we’ll look at some common use cases when writing a markdown file. We’ll first look at simple text formatting like bold, italic, or strikethrough. Next, we’ll look at writing numbered lists. Finally, we’ll look at creating and modifying tables. Let’s get started! Bold, Italic, and Strikethrough Text Let’s start with the simple stuff. In markdown syntax, you can make your text bold by wrapping your text in , italic by wrapping your text in , and strikethrough by wrapping your text in . It’s not a huge burden to type out these characters, but it’d be really nice if we could just use keyboard shortcuts to format the text in the same way that we can when working with a Google doc. ** _ ~~ Here’s the markdown we’ll use to apply these styles: And here’s what the output looks like when viewing the markdown file: Now, let’s show how easy it is to apply these various styles when using the VS Code extension! We can make our text bold using , italic using , and strikethrough using . Cmd+B Cmd+I Option/Alt+S Numbered Lists Next, let’s take a look at lists. When creating a numbered list in a Google doc, hitting the key after typing your first list item creates the second list item with the prefix already in place. In a markdown file, however, you have to manually type the number prefix for each item. It’d be nice if we could have that done for us automatically! Enter 2. Here’s the markdown we’ll use to create a numbered list: And here’s what the output looks like when viewing the markdown file: Now, let’s show how easy it is to create a numbered list when using the VS Code extension! We start by typing to create the first item in our list. Then when we hit the key, the next number prefix is added for us automatically! 1. Bread Enter Tables Finally, let’s look at creating and modifying tables in markdown. Tables are easy enough to create, but a pain to modify, especially as the column widths change. Here’s the markdown we’ll use to create a table: And here’s what the output looks like when viewing the markdown file: Now, let’s see a demo of how long it takes to create the table from scratch without using the VS Code extension. Note how much time we spend modifying the column widths, and we’re only doing this for a table with three rows! Imagine doing this with a much larger dataset and how much of a headache this would be. Now, let’s show how easy it is to create and modify a table when using the VS Code extension. For starters, we can insert an empty table by right-clicking in our file to open the context menu and then selecting “Table >> Table: Add.” We can then specify the number of columns and rows and hit to create the dummy layout. Enter Then, as we enter text into the table, we can navigate from cell to cell using and . Whenever those keys are pressed to navigate to a different table cell, the column widths automatically adjust. This is probably my favorite feature! Tab Shift+Tab You can find even more cool features in the right-click context menu or by reading the . extension’s docs Conclusion This markdown tool is incredibly simple, but it’s often the simple things that make the developer experience better. The SFDocs Markdown Assistant looks like a VS Code extension I’ll be keeping around! Also Published Here

Google

Salesforce

How to Use Insomnia to Upgrade Dependencies 

How I Built My Own Insomnia Plugin

Easily Formatting Markdown Files in VS Code

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

Heroku for ChatOps: How to Start and Monitor Deployments From Slack

A New Approach to Date Formatting In Swift

Slogging Editor Updates: New Formatting Added for Bullet Points, Bold, and Italics

Uderstanding the Basic Structure of a Website

28 Stories To Learn About Markdown

Heroku for ChatOps: How to Start and Monitor Deployments From Slack

A New Approach to Date Formatting In Swift

Slogging Editor Updates: New Formatting Added for Bullet Points, Bold, and Italics

Uderstanding the Basic Structure of a Website

28 Stories To Learn About Markdown

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps