Steemit Markdown Basics for BeginnerssteemCreated with Sketch.

in #steemit6 years ago (edited)


How to Stock Photo

If you are starting out it can be confusing getting to grips with Markdown.

Markdown is a formatting system that allows you to make posts quickly using symbols as shortcuts for formatting without the hassle of using html.

Here are some of the most basic markdown shortcuts that I personally have started using.

Why use Markdown over HTML?

Simplicity Stock Photo

  • Simplicity and ease of use compared to HTML/CSS.
  • Faster than HTML/CSS due to less typing.
  • Faster than the WYSIWYG Steemit text editor for similar reasons.
  • Easier to read/review/spot errors and also edit compared to HTML/CSS.
  • Can be combined with HTML/CSS for more advanced formatting and features.

Once you learn how to use these very basic techniques you will be much quicker at posting.

Other Resources I Recommend

  1. For more detailed information I would suggest using the Markdown Cheatsheet by Adam Pritchard which has been recommended by a number of people.
  2. You can also pick up tips from other users - there is nothing wrong with asking!
  3. In addition I should mention that @charlieshrem has created a markdown editor at which is also a very useful tool for composing and posting in markdown. Not only that but it also allows you to save your posts and submit them directly to Steemit!

Format of this post

I will be using screenshots to illustrate the actual text you type into the markdown editor and then illustrate the preview that you get.

(This is because if I actually put the markdown text in the post it will not show as is but will become formatted according to the markdown specs.)

The markdown text you type has a CREAM background colour to stand out.

Basic Points Before we get to the Markdown

Here is a view of what you see when you click on the "Submit a Story" button (A) at the top right of your Steemit browser window:

The default view allows the entry of markdown or html below:

If you click on the top right corner where it says "Editor" (B) it will take you to the very basic text editor which is fine but WILL NOT allow you to use markdown or html.

Further it could in the past cause you to lose certain html/markdown formatting so I think the last update prevented switching once you start entering text in order to prevent this happening.

That said you can still go into the regular text editor by accident before you start typing. If you find your markdown is not working this may be the reason. If you can't see the "Markdown" button to switch back you will need to do this:

Copy your text to the clipboard or a separate document and hit clear (C). The "Markdown" option should reappear as shown below (D), click it and then you can paste your text back in.

The Markdown Bit (Finally!)


This is one of the best points about Markdown.

Unlike html where you need to use formatting tags for paragraphs, simply hitting Enter/Return once or twice in Markdown will create paragraphs (depending on how you prefer to format).

It works exactly the same way as a standard word processor.

That saves a lot of typing compared to html.


For headings use a hash symbol "#" followed by a gap:

e.g. you type this:

Headings MD

and you get this:

Heading 1

Heading 2

Heading 3

The more hashes you use the smaller the heading.

You can use up to 6 - NB don't forget to leave a gap between the hashes or it will confuse the editor.


Italics use underscores or asterisks

e.g. you type:


and you get this:

underscores or



For bold use double underscores or asterisks

e.g. you type:


and you get:

double underscore

double asterisk

Both Bold and Italic Combined

Mix them (asterisks and underscores) for text that is both italicised and bold:

e.g. you type:

Mix Bold Italic

and get:


Numbered Lists:

You type numbered points like this, the number followed by a full stop/period:

Number Lists

and you get this:

  1. Point 1
  2. Point 2
  3. Point 3

Bulleted Lists

For bulleted lists use asterisks with a space:

You type:

Bullet lists

and you get:

  • Point 1
  • Point 2
  • etc


The easiest way to do these is to use square brackets to surround your title followed by round brackets (without a gap) with the link:

e.g. you type:


and you get:


Images are similar but formatted like this:

![Title Text](Image link here "Image Name")

You type:

Images MD

and you get:

My Water Texture Image

{N.B. You don't have to use a separate image name and file name and can simply use ![Image Title](Image Link) or even use just a link on it's own for Steemit - but just in case there is a problem with the link loading I would still use a title though.}

Youtube Videos

Thanks to @kryptik in the chat for asking about these as I forgot to mention these in the original edit. Basically just treat the youtube video like an image link so the format would be:

![Youtube Link Title](Youtube Video Link)

Quotes use the "greater than" mathematical symbol i.e. ">"

e.g. you type:

Quotes MD

and you get:

This is a quote.

Section Dividing Lines

Three or more asterisks, hyphens, or underscores make a dividing line to separate sections. (Thanks to @cristi for showing me this):

e.g. you type:

Section Divisions

and you get 3 identical dividing lines:

The above all look the same in preview regardless of which triple symbol you use.

Extra tips

If it isn't working there are 3 common possibilities:

  1. You have either a space missing (headings - the editor will see it as a tag) or an extra space in the case of other types of text.
  2. You are using the text editor which does not read markdown (which I explain near the top of the post).
  3. You are using a feature that is not compatible with the Steemit implementation of markdown - this might happen if you are using some obscure functions.

If you get stuck - ASK for help or use Google - there are plenty of online resources like the aforementioned Markdown Cheatsheet.

NOTE - If you use for image hosting it will automatically create Markdown formatted links for you (plus HTML versions and more) as shown in the screenshot below:

SteemImg SC

Thanks to @blueorgy for creating this valuable tool for us to use.


These are just the basics to get you started. In fact I don't really use anything else besides these markdown tricks to format my post. As I stated earlier you can find plenty more information on line. I hope this has been useful and easy to understand. Please let me know if you spot any mistakes or anything is unclear.

The Obligatory Kitten Shot

Your reward for getting to the end:-
Kitten Shot

If you like my work and aren't already, please follow me and check out my blog (I mainly discuss photography but I do other topics too) - @thecryptofiend

Image Credits: All images that aren't personally taken screenshots are taken from my own Thinkstock account. More information can be supplied on request.

I have also created a new channel in the chat dedicated to photography of people/portraits called "Photography-portraits-people". Please check it out and post your photos there.

(Verification for me here:

Some of my Previous Posts and Tutorials:


Great post! very informative - I still can't figure out how to make a large space between words on the same line . Any help would be appreciated.

Can you please tell me that how can i get paid and if I want to replace this money with cash how can i do that .......please answer this

not sure I understand the question - Steemit will automatically pay you every 7 days from the time you made a post - once that happens you can get your money "powering down" which is what they call it when you want to convert your steem - there are lots of posts and videos that go into more detail. I'm not sure exactly how to do it since I've never cashed out- I'm trying to convert all of my steem to steempower. Best of luck to you.

You just have to use multiple spaces I think.

Thanks.. but I've tried that and it only moved it over one space... back to square one

@jorlauski, remembering my old days of HTML use, I tried this and saw that it worked on the Markdown interface. Just use this (but without spaces, it won't show here if I type it as it should be written):
& n b s p ;
So just remove the spaces between that code, and use as many of them as for the amount of space characters you want in between your words!

Thanks, but sometimes out of nowhere, a word in a paragraph will start on a new line in Steemit posts. Do you know how to stop this happening? Its happening on my post about the Games Industry, but seems to disapear if you make your page width smaller.

The Steemit layout may not allow it.

Kinda late but you can write " "

thanks - i use "& nbsp;" quite regularly - its good for making a new paragraph ... but if i want to make a space on the same line.. I should be able to use the space bar like in Word.... but no matter how manny spacs I put in ... steemit markdown defaults to ONE space... si I'm back to where I started and I never found a good answer to my question - so if anyone knows .. I would totally appreciate it.

I thought putting multiple " " would add multiple spaces on the same line like so:
steem          it

Issue with controlling the spacing between words/characters is the word wrap in Steemit's style. It is set to make Steemit as responsive as possible for tablets and phones. There are ways to do it but mobile view of post may differ.

📌 Possible Solutions:

  • You can use HTML <pre></pre> tags to get your desired function.
    • Demo:
      P R E                 FORMATTED      Text 
  • Aside from &nbsp; there is &ensp; x2 as big &emsp; x4 as big.
    • For increased distance between elements, use multiple times.
  • One last way, you can use a transparent graphic to specified width.
    • Code: Spacing![](!
    • Demo:

📌 If you want more control of post layout, learn steemit HTML.

⚠ I'm working on an app to help make it easier to use HTML: Find out more...
This post was edited with HastyMarkup!

thanks for the info - it's useful - I'll check out the app you were working on

glad i found this

Glad it is useful for you.

Yeah.. Me too


I'm still a beginner so thank you very much for this guide!

You're welcome:)

Thank you very informative!

You're welcome:)

Very helpful post for a complete beginner, thank you!

Glad you found it useful:)

Thank you, very helpful!

Thanks for the great explanation. I am new here and will surely take a big profit from this article. Good luck!

Welcome :)

please up vote

Very helpful. Will follow while creating my first post. :)

Cool thank you!

this guide rocks. thanks @thecryptofiend

You're welcome!

btw, I am relatively new to steemit. Is there a way to save specific posts to like a bookmark section to have as quick reference? thanks

Well you could just bookmark them in your browser. If you resteem they are saved to your feed in a way at least - although everyone can see them.

please up vote

Well it looks like your going to help me become a better writer with this type of programming and its formats. I guess the program only accepts it the way it needs to be written. Its kind of new to me I might need some help still.

awesome these information took time reading but definitely worth it...Thank you so much

Nice work and good info.. So good to be a steemian.

This guide is very helpful, hopefully it will make my posts look nice.

Any Markdown for aligning pictures to centre?

Thank you!

please up vote

Thanks for those really useful tips.
I'm new to steemit and have never used mark down before,so I really appreciate all the time and effort you have put into it,in my opion a "must read " for beginers. (I'm going to practice mark down now)

Thank you so much for this, I have bookmarked and will be returning.

please up vote

Amazing post. Has all the information you need on how to format your steem posts. I will probably refer to it consistently.

Glad it is useful for you:)

Completely new to all of this! This was very helpful! Thanks :)

You're welcome!

Thank you. As beginner, this post is very helpful.

Thank you for sharing this. Being new to Steemit, it is very helpful plus you used pretty simple and straight language without Jargon which made it easy for someone like me to digest easily. Thanks once again.

Yaaaaaaaaaas!!! This was of great help! Cheers

Thankz for the info...its very helpful for a newbie like me.

Thank you very much! Very helpful to a slow beginner like me. I upvoted and follow your amazingly varied outputs!

Thank you for posting this amazing walkthrough. It answered a ton of questions I had as a new Steemit user.

May the Steem flow your way!

Thank you!

Thanks @thecryptofiend!!! ,very helpful (Y) <3

Vaya esto sera de ayuda


great tutorial. markdown is a versatile formatting tool

Well worth the read, thanks!

Thanks alot! I need to practice, never made posts before this is very helpful

Thanks for the time-saving tips! Good work!

You're welcome!

Very informtive

Thank you
I am already putting it into practice


Thank you for helping with the preparation phase for posting. These has been really helpful. I will bookmark this page for reference. :)

Glad you found it useful!

Thanks for posting, this helps a steemit greenhorn like me immensely! (just used my 1st markdown codes!)

Your post is well written and super clear; you show the code and then how it looks in Steemit, nice. upvoted and followed.

Thank you - it really speeds up formatting IMO:)

Gracias, es de mucha utilidad, no he buscado si existe esta informacion en mi idioma.

thanks for the tips. takes a bit of getting used to this :)

You're welcome!

It really showed me reason why my two previous posts look ordinary. But am still having problem with the don't know how to go by it. Any help will be grateful

You don't have to use it anymore you can drag and drop into the post. If your first image isn't showing up just use markdown for that and you can use Imgur or Imgsafe as alternatives.

Danke für die sehr ausführliche Erklärung und den hilfreichen Links.

Hi @thecryptofiend, I just stopped back to let you know your post was one of my favourite reads and I included it in my Steemit Ramble. You can read what I wrote about your post here.

Thank you for you support. I will check it out now:)

Very helpful thank you and I got to the beautiful kittens, :)

Hey @thecrypofiend.

After the new hardfork has apparently scrapped the "Raw HTML" option, this is a perfect tutorial to proper formatting and shortcuts to get there.

Fantastic post as is the norm with you!

Thank you. I think you can still use html with markdown. You just can't switch between the text editor and html once you have started typing.

Exactly. I was so used to typing it up on the editor and adding presentational markdowns later.

So your guide is all the more awesome for helping me out!

Thanks. I have been forced to use it more due to being rushed and it is a lot faster than using html alone!

Thanks very much for this info! I was mixing html with the markdown since the last Steemiy update but this way is going to be definetely easier and faster.
Resteeming 👍

@dresden I've been doing the same thing. Thanks, @cryptofiend for this helpful helpfulness. The line breaks are going to be an especially big time saver for me, since I am an 100% mobile user, and those html tags don't flow as easily on my smartphone vs. computer. Thanks!

I think for some things like centering text you still need to use html but for everything else this is easier.

@jessamynorchard Thanks glad you find it useful. It is hard enough using those tags on desktop so I can only imagine how hard it is on mobile!

Great, bookmarked for future reference.

Thanks glad you found it helpful:)

Thank you for this, I really needed a bit of guidance with this stuff so cheers.

You're welcome. I'm glad you found it useful:)

It is useful, thank you.
But because steam -redaktor html accepts, no?

Do you mean does Steemit allow HTML? Yes absolutely you can use either markdown or HTML or combine both of them.

This post has been linked to from another place on Steem.

Learn more about linkback bot v0.4. Upvote if you want the bot to continue posting linkbacks for your posts. Flag if otherwise.

Built by @ontofractal

Great article and a great example of how to write a useful article! Fantastic job. :)

Thank for your kind words. I just hope it isn't too confusing.

Another excellent post @thecryptofiend!

I really learned something today!

Sure did, I knew nothing about this 3 months ago and have been learning the whole time.

Now I have a few new skills to implement!


Thanks for letting me know. I've actually upgraded the screenshots of the text a little bit to make it clearer.

Great tutorial! I think this will be helpful for a lot of people. I definitely prefer markdown over raw HTML. HTML allows more fine-tuned control, but it can be finicky to get it just right and it feels more clunky than the simpler markdown syntax. Markdown also makes it easy to establish and stick with a consistent style from post to post. Becoming proficient with it is something that every aspiring blogger should aim for!

Thanks. Yes I definitely agree:)

Thank you so much that is very helpful!

I'm glad it helps:)

Thank you, I just learned a few things!

Great. I'm glad you found it useful:)

Great post there @thecryptofiend This will help me a lot! :)

Great glad it helps:)

You call markdown simple ?
I don't even want to know what you consider complex.
That said, thank you very much, Sincerely.
I've figured out most of that. Although I still don't understand the image thing.

It is once you get using it lol:) What don't you understand about the image thing?

dunno. If I understood what I don't understand I'd understand it.
I don't see how this![alt text](image link here "Title text")
translates into

I also find this part of markdown confusing. I can type <img src="http://LINK.png" alt="DESCRIPTION"> faster than I can understand that. To each her own.

OK I didn't spot that ! I'll change it to make it clearer. Edit: OK it's changed.

great blog, really a big help for newbie like me, thanks :)

Thank you. I'm happy you found it useful. Let me know if there is anything else you would like me to cover:)

Thanks you @thecryptofiend for this informative post. I've ignored markdown, just keeping it basic with the editor to focus on the writing. But, it appears that the times are a changing and the opportunity to gain new skills has arrived. Thanks for making it more comprehensible and less intimidating. Off on the road to new discovery!!! UPvoted and resteemed. I'm already following you!!

Thanks for your support. I'm pleased you find it useful:)

Top stuff, man. A real help. Appreciate it. Reposted so I can refer to it when I need to.

Thank you. I'm really pleased it is helping:)

this is still intimidating simply because it seems so time consuming. I will try it out fully though at some point and am grateful for your detailed instructions that will guide me through!

Yes it can seem that way but once you start doing it you will pick it up very quickly and it is a lot faster than using html tags.

Is there an easier "pull-left" command?

BTW, no puppies = no vote! :P

<div class="pull-left">Lorem ipsum</div> Cannot be simplified because it is calling on a CSS stylesheet. For more information about using these divs effectively see How to Wordwrap Your Images Like a Boss.
I've included a template at the end.

Some really helpful tips there. Thanks.
You can do a simple line break with three asterisks. ***

There is another way to float an image. It seemed easier than the div pull command when I saw it. Maybe someday I'll see it again and write it down this time.

Have you figured a way to get links to show in your description of an image that's pulled left/right? I've tried different things, but the url always gets written out no matter what I try. But the only time I've done the "img src" command was when working with HTML.


<*img align="right" src="doc/subpagelist.png">

Makes it float, but doesn't seem to have "right" or "left" influence here.


without the < does the same thing. Can't find a way to make it stay to the right or left though.

Might be useful though. :P



I'm not sure what you mean by pull left?

like this
Like when you want an image to post to the right or left of the text.

You would have to use tables I think. It is in the Markdown Cheatsheet - I haven't tested it myself because I have never had the need to use it. Let me know if you try it and if it works or not.

I don't know much about coding, so just find what I can to make it happen. But I did recently run across a way to do it in Markdown. I was in a rush and failed to make a note. Of course, we always remember everything when we're rushing, right? Sigh...

I think it might have been using the tables function. Hopefully someone will mention it again:)

Well, it worked in my reply above. But it's a little clunky. I saw somewhere that there's an easier way, but I didn't write it down or save it. Here's how I'm doing it now.

OK thanks for the link will check it out when I have a moment:)

Edit OK cool it looks like it is just CSS rather than a Markdown implementation.

The crazy thing is I was upset when I saw the HTML link go away on the post editor. So instead of learning Markdown I started doing all my post in Bluefish which is an HTML editor. Then I copy that code into the post editor and it recognizes my HTML. I think it is tough to make the posts the way I want them if I'm just using the regular editor on here.

That's basically what I was doing before even though I knew how to use markdown and was using it for comments. The change has forced me to use markdown for my posts too and it is actually a lot easier and quicker than the html method. That said I was just typing out all the html into a text editor rather than automating the process in any way. I just find it works better for the way I think and write.

I just got 2 more content creators to join. I will link this post to them. Good post, Thanks.

Thank you for your efforts for Steemit. Glad you are finding this useful too:)

Every little info helps...this is a lot..thank you.

I'm glad for that, thank you for support:)

Upvoted at 100%. This is a very helpful post to those of us too lazy to HTML. Like me.

Thanks glad you found it useful. I would call it being smart with your time:)

Oh! I did my first post 2 days ago and had few stupid question. This article explains everything with all necessary details. Thank you!

Thanks glad it is useful for you:)

Thanks. I needed that. I was a bit upset that the raw html editor was taken away actually

It's still there - you can use html the same as before - you just can't switch back and forth between the text editor and html/markdown. I still use html if I want to center an image but I find generally markdown is a lot quicker.

@thecryptofiend so there's actually that.
New thing learned thanks a great lot!

Thanks for reading. I'm glad it's useful.