"Assumption is the mother of all mistakes." -Eugene Lewis Fordsworthe Hello readers, In response to the upcoming release of our new editor option, I decided to discuss 'markdown' - a topic that several of our users may not be familiar with. When we first announced the development of a new editor supporting markdown, I wrongly assumed that everyone was already acquainted with it. This article will help you understand the key features of markdown and, who knows, you might end up being an early adopter of our new editor! What is Markdown? Markdown is a tool that allows you to create formatted content using plain text. It is essentially a set of rules that interpret certain special characters in text to present it as HTML. You've likely noticed it when people enclose words with asterisks to emphasize them. With markdown, words surrounded by asterisks actually appear italicized. A word enclosed by double asterisks, **bold**, for instance, will be . bold Another clear illustration of markdown syntax is the numbered list: First item Second item Third item Fourth item Evidently, it's quite user-friendly. Simply typing "1." and hitting space will help you create a numbered list. An unordered list is equally straightforward. Just type an asterisk or a hyphen followed by a space, and you can create: a bullet item another bullet item to stop adding items, press enter twice You can also create a nested bulleted list: like this: hit tab to create a nested bullet and shift+tab to move up a level back to the top The simplicity of markdown makes it easy to convert basic text into a well-structured document. If you type ">" followed by a space, you will create a block quote: Don't quote me on this, but this markdown stuff is very convenient! You can use hashmarks "#" to create headings. The more hashmarks you add, the smaller the heading. So, "#" creates: This h1 header "##" creates: A smaller h2 header "###" creates: An even smaller h3 header And "####" creates: The smallest h4 header And no, you cannot go any further with the headers! However, markdown isn't short of tricks to enhance your text. Typing "---" creates the dividers that I've been using to segregate each markdown feature. Once the third dash is typed, a divider appears instantly. Somewhat peculiarly, if you type "***", it's necessary to hit space to create a dashed Page Break. I'll admit, I'm unsure why both types exist and why a space is required afterward. Creating links is slightly more complex: [visible text](https://link-to-a-site.com) Transforms into: visible text You may prefer to use the ctrl/cmd + K shortcut to create links instead. Alternatively, you can highlight text in the editor and a pop-up with a link icon on the far right will also convert text into clickable hyperlinks. Images follow a similar syntax: ![caption goes here](https://cdn.hackernoon.com/images/ckr-3-vyhp-000040-as-6-byan-6-x-08.jpg) It just starts with an exclamation mark (!). The caption appears in small italic font under the image and is also set as the property on the tag for better accessibility. Currently, the image uploader modal is missing from this editor, so you'll need to find your image URLs yourself. You can also insert an image from your machine by dragging and dropping it right into the editor. alt img One special bit of syntax that is supported, but isn't strictly markdown, is . ==two equals signs== This will Fun! 🎈 highlight the text in green. Conclusion That concludes our rundown of the markdown features supported by the new editor. We believe markdown will provide a convenient way to format your stories or import your prewritten markdown into our editor. Just copy and paste your markdown and watch it transform into an elegantly formatted story! This will also pave the way for an API that could take your markdown content and create or submit the draft without using an editor - you'd just send plain text markdown over the network.

If bugs were ghosts, he's our ghostbuster

Richard

OpenSea Collections

Support The EFF!

VP of Engineering @ HackerNoon

Support the EFF

AI Image Generation in the HackerNoon Editor (with Stable Diffusion)

Instant Search and Related Stories: Algolia + HackerNoon

Markdown For What?  or Why Do We Want Markdown In Our Text Editor??

Too Long; Didn't Read

In your car, at home, or at work — Bosch technology shapes many areas of life.

Markdown For What? or Why Do We Want Markdown In Our Text Editor?

Too Long; Didn't Read

RichardJohnn

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

Markdown For What? or Why Do We Want Markdown In Our Text Editor?

Too Long; Didn't Read

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

RELATED STORIES