Steemit Markdown Basics for BeginnerssteemCreated with Sketch.

in #steemit7 years ago (edited)

Introduction

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 Steempower.org 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!)


Paragraphs

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.


Headings

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

Italics use underscores or asterisks

e.g. you type:

Italics

and you get this:

underscores or

asterisks


Bold

For bold use double underscores or asterisks

e.g. you type:

Bold

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:

Mixed


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

Links:

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:

Links

and you get:

Steemit


Images are similar but formatted like this:

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

e.g.
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 SteemImg.com 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.


Conclusion

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: http://www.aapicture.com/about-me)


Some of my Previous Posts and Tutorials:

Sort:  

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![](http://de.mo/50px-spacer.png)Example!
    • Demo:
      SpacingExample!

📌 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

Loading...

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

Coin Marketplace

STEEM 0.35
TRX 0.12
JST 0.040
BTC 70455.47
ETH 3561.82
USDT 1.00
SBD 4.71