Home
Q&A
Line breaks, pictures, links and other formatting tricks

Line breaks, pictures, links and other formatting tricks

49
votes

Using Markdown to Format your Posts

Contents

?Introduction

?Adding Images to your Post

   ?Preliminaries: Obtaining an Image URL
   ?Markdown Example
   ?Troubleshooting
   ?Posting a Picture From Your Own Computer

?Adding Links

   ?Obtaining a URL
   ?Markdown Syntax: Special Characters
   ?Markdown Example
   ?Troubleshooting your link

?Bolded Text

?Headings

?Italicized Text

?Line Breaks and Spacing

   ?Single Spacing
   ?Double Spacing

?Tables

   ?Table Definitions
   ?Table Markdown Examples
   ?Table Markdown Example: 2 Columns
   ?Table Markdown Example: 3 Columns
   ?Table Markdown Example: 5 Columns, No Set Header

?Other Resources and Links

Introduction

Overview

Many people have shown interest in knowing some of the tricks to formatting that can be used within the "Answers" section. Previously, I posted an attempted explanation at some of the uses of HTML that are available. While the use of HTML (also know as "markup") allows you to perform a variety of formatting tricks, its syntax can also be a bit tricky at first, especially to those with little or no interest or experience in computer languages or programming.

That being said, the web-writer that Spanishdict uses (the text-to-HTML program that is used to publish what you write to the web) actually employs a language called "Markdown," a language that is a bit simpler and a bit more intuitive (albeit more limited) than HTML. If you have done much posting on SpanishDict you are probably already familiar with at least some of the syntax of the markdown language. Here I will try to discuss and provide additional examples with which you might not be quite so familiar

Back to Table of Contents

Adding Images to Your Post

Preliminaries: Obtaining an Image URL

To add a picture, you mustl first know the picture's web address/URL (the web address will usually start with the letters "http://www."). A simple way to find the web address for your desired picture is by right clicking on the picture and then clicking on the option that reads, "Copy Image Location." This will automatically copy the URL to your virtual clipboard. Once the URL has been copied to your virtual clipboard, you can later paste the URL into the appropriate position within the Markdown code by holding down "Ctrl + P."

Back to Table of Contents

Posting the Image

To post the image you will need to use the following set of characters:

Character Example Explanation
Exclamation Point ! Marks the Markdown to follow as an image link. The exclamation point will be followed by a set of square brackets immediately followed by a set of parenthesis containing the images URL
Square Brackets [ ] The set of square brackets follow directly after the exclamation point. Inside the square brackets, you can place text to describe what the picture is supposed to be. The square brackets are a mandatory part of the code. Text inside the brackets is optional but can be useful should the picture fail to post.
Parenthesis ( ) You will paste the URL for the desired image within the set of parenthesis. The set of parenthesis follows directly after the set of square brackets
Back to Table of Contents

Markdown Example

![My Avatar](http://a.sdswift.com/uploads/avatars/b/160/bd321fe6f402bcd022d31f0e_160_160.jpg)

Result

My Avatar

Back to Table of Contents

Troubleshooting

There may be times when you find that a picture does not post. Many times the reason for this is that the URL address for the picture that you have selected is not formatted in a way in which the editor is able to recognize. If the URL contains any blank spaces, the pic will not post. For example, note the following differences:

Unrecognizable http://www.A picture that you want.gif
Recognizable http://www.A_picture_that_you_want.gif
Recognizable http://www.A+picture+that+you+want.gif
Back to Table of Contents

Posting a Picture from Your Own Computer

Files from your own computer have not been published on the web and do not carry a URL. Because of this, there is no direct way to post a picture from your computer onto the forum. However, there is a roundabout way to achieve this goal. If you open up a free account with an image hosting websites such as photobucket you can load your photo to your account on that website and copy the URL from there. When doing this, just remember that when you name your file, you will have to give it a name that does not use any blank spaces. For example, YourFileName or Your_File_Name (correctly named) vs. Your File Name (incorrectly named).

Adding Links

Obtaining a URL

To add a link, it will first be necessary to know the picture's web address/URL (the web address will usually start with the letters "http://www."). To capture the target web address, navigate to the desired webpage and right click on the URL as it appears in the navigation bar at the top of your screen. Make sure that the entire URL is highlighted and then click on the option that reads "copy" and this will copy the URL to your virtual clipboard where you can save it until you are ready to paste it into the appropriate position within the Markdown code (you can paste the URL by holding down "Ctrl + P").

Back to Table of Contents

Markdown Syntax

Explanation of Special Characters

To post a link you will need to use the following set of characters:

Character Example Explanation
Square Brackets [ ] The set of square brackets tells the text editor to look for a link. Type your desired link label inside the square brackets. The square brackets are a mandatory part of the code, but the text is optional yet useful in case the link fails to post.
Parenthesis ( ) You will paste the URL for the desired link within the set of parenthesis. The set of parenthesis follows directly after the set of square brackets
Back to Table of Contents

Markdown Example

[A Link to SpanishDict's Reference Page](http://www.spanishdict.com/answers/100000/spanishdict-reference-guide)

Result

A Link to SpanishDict's Reference Page

Back to Table of Contents

There may be times when you find that a link does not post. Many times the reason for this is that the URL address for the link that you have selected is not formatted in a way in which the editor is able to recognize it. If the URL contains any blank spaces, the link will not post. For example, note the following differences:

Unrecognizable http://www.A link that you want.com
Recognizable http://www.A_link_that_you_want.com
Recognizable http://www.A+link+that+you+want.com
Back to Table of Contents

Bold Text

To bold text you can either use the "double-asterisk" (**), with which most of you are probably already familiar, or you can use the "double-underscore" (__). For example, the Mardown in this example would produce the following results:

Markdown

**Bold** using "double-asterisks" or __Bold__ using "double-underscores"

Result

Bold using "double-asterisks" or Bold using "double-underscores"

Back to Table of Contents

Headings

Markdown supports six different heading sizes (although there actually does not appear to be much descernable difference between heading 4 and 5 - see below). These can be accomplished by placing from 1 to 6 hashmarks (#) in front of the text that you wish to use as your heading. For example, the Markdown in this example would produce the following results:

Markdown

# Heading Level 1
## Heading Level 2
### Heading Level 3
#### Heading Level 4
#####Heading Level 5
######Heading Level 6

Result

Heading Level 1

Heading Level 2

Heading Level 3

Heading Level 4

Heading Level 5
Heading Level 6

Additionally, a level 1 and level 2 heading can be created by simply placing, on the line directly below your desired text, two or more dashes (-) for a level 2 heading or one or more equal signs (=) for a level 1 heading. For example

Markdown

Heading Level 1
==
Heading Level 2
--

Result

Heading Level 1

Heading Level 2

Back to Table of Contents

Italicized Text

To italicize text you can either use the "single-asterisk" (*), with which most of you are probably already familiar, or you can use the "single-underscore" (_). For example, the Markdown in this example would produce the following results:

Markdown

*Italicized* using "single-asterisks" or _Italicized_ using "single-underscores"

Result

Italicized using "single-asterisks" or Italicized using "single-underscores"

Back to Table of Contents

Line Breaks and Spacing

While Markdown does not allow you to add three or more blank lines between blocks of text, it does allow for both single and double spacing. Being able to separate lines of text is probably one of the most useful as well as one of the simplest formatting techniques to do using Markdown.

Back to Table of Contents

Single Spacing

Placing single line breaks between blocks of text is very easy and useful (especially if you are trying to post lines of poetry). All that you have to do in order to single space your text is to place two or more blank spaces after your text before you hit enter (i.e. to start a new line, press the space-bar key twice before you hit ENTER). For example, using these keystrokes would produce the following results:

Markdown

Desired Text Keystrokes Needed
To end your line [SPACE][SPACE][ENTER]
With single spaces [SPACE][SPACE][ENTER]
Just end the line [SPACE][SPACE][ENTER]
With two blank places [SPACE][SPACE][ENTER]

Result

To end your line
With single spaces
Just end the line
With two blank places

*Corny, but I hope it gets the point across

Back to Table of Contents

Double Spacing

Creating line breaks using double spacing is very simple. All you have to do is press ENTER twice at the desired break point and you will create a new line of text with a blank space in between each line of text. For example, using these keystrokes would produce the following results:

Markdown

Desired Text Keystrokes Needed
To place a space [ENTER][ENTER]
Between two lines [ENTER][ENTER]
Just hit ENTER [ENTER][ENTER]
Two more times [ENTER][ENTER]

Result

To place a space

Between two lines

Just press ENTER

Two more times

Back to Table of Contents

Tables

Defining Tables

Creating tables with Markdown take a little getting used to, but once you understand the key concepts, it is really very easy. Before looking at an example of table formatting, let’s first look at what makes up a basic table.

Three Key Points

1). Headers/Row1Each column of the table will be represented by placing each column between a set of pipes ? | | (The pipe character can be found below the backspace key). For example, here is what you might type for the first row of a three column table:

Row 1 ? | | | |

2). Dividing Lines: Directly beneath each column heading (your second row of pipes) you will have to create a matching set of pipes with dashes in between each pipe on the second row. Note that the number of dashes and blank spaces that are used between each set of pipes on the second row is arbitrary and will make no difference in the final appearance of your table. Here is an example of what you might type for the first two rows of a three column table

Row 1 ? | heading 1| heading 2 | heading3 |
Row 2 ? | --- | --- | --- |

3). Finally, table alignment within each row is achieved by placement of colons at the edges of each set of dashes. For example:

   •Left Alignment ? Default (no colon necessary)
   •Right Alignment ? colon on right side of dashes ? | ---: | ---: | ---: |
   •Center Alignment ? colon on each side of dashes ? |:---:|:---:|:---:|

Back to Table of Contents

Markdown Examples

Two Columns

Code:

| Heading 1 | Heading 2 |
| :-------: | :-------: |
| Item 1.1 | Item 1.2 |
| Item 2.1 | Item 2.2 |
| Item 3.1 | Item 3.2 |

Result

Heading 1 Heading 2
Item 1.1 Item 1.2
Item 2.1 Item 2.2
Item 3.1 Item 3.2

To be clear, it is not actually necessary to make each of the pipes ( | ) line up when you are typing out your table. When you post your response, the columns will automatically line up. What is important is that the number of columns in each row should match up. For example, if you have a table with four columns then for each row, you would need to type out 5 pipes ( | | | | | ). It should also be noted that the actual number of dashes that you type between each set of pipes on your second row is arbitrary, and as long as you type at least one dash for each column, your table should come out right ( |-|-|-|-| ). For example, notice that in the following example, a single dash is used as a dividing line for each individual column:

Back to Table of Contents

Markdown: 3 Columns

Code:

| Heading 1 | Heading 2 | Heading 3 |
| :- | -: | :-: |
| Left column | Middle column | Right column|
| Left-Aligned Text | Right-Aligned Text | Centered Text|
| 200 | 200 | 200 |
| 20.000 | 20.000 | 20.000|
| 2.000.000 | 2.000.000 | 2.000.000 |

Result

Heading 1 Heading 2 Heading 3
Left column Middle column Right column
Left-Aligned Text Right-Aligned Text Centered Text
200 200 200
20.000 20.000 20.000
2.000.000 2.000.000 2.000.000

There may be a time in which you do not wish to use headers, or you might wish to leave a particular cell within the table blank. To do this, you just leave the space between the desired bars blank. For example:

Back to Table of Contents

Markdown: 5 Columns, No Set Headers

Code:

| | | | | |
| - | :-: | :-: | :-: | :-: |
| | **Birds** | **Mammals** | **Insects** | **Fish** |
| **Six Legs** | No | No | Yes | No |
| **Wings** | All | Rarely | Many | None |
| **Gills** | No | No | No | Yes |
| **Multicellular** | Yes | Yes | Yes | Yes |

Result

Birds Mammals Insects Fish
Six Legs No No Yes No
Wings All Rarely Many None
Gills No No No Yes
Multicellular Yes Yes Yes Yes

Notice that by leaving your header row blank, you can still set your headers off from the rest of the table by using the bold-text Markdown.

Other Resources and Links

The following websites provide additional information regarding some of the other formatting features available through the use Markup:

?PHP Markdown Extra
?Markdown Cheatsheet
?Daring Fireball: Markdown Basics
?Daring Fireball: Markdown Syntax

Back to Table of Contents

End

Please feel free to post any questions or comments below!

Saved in 2015 without any editing changes to see what still works.

62778 views
updated Aug 23, 2017
edited by DilKen
posted by Izanoni1
My goodness that's massive! Bien hecho that's going to be a great reference article - thanx for the effort :) - Kiwi-Girl, Aug 11, 2010
change it to reference article, this is great! - swing, Aug 11, 2010
Holy cow! And to think I was afraid of sounding geeky with my two bits of HTML explanation! :-D Great stuff!! - Gekkosan, Aug 11, 2010
Just one detail that people may not realize: oftentimes the URL's for images show % marks, which essentially are the way that web servers indicates that the name indicated in the address contains spaces. Thus, you can get something that looks like this: - Gekkosan, Aug 11, 2010
http://www.A%picture%that%you%want.gif, which is exactly the same as the troubleshooting example with the spaces, and therefore it is also not recognizable. This is really great! A condensed HTML course for SD! Valuable stuff, people! - Gekkosan, Aug 11, 2010
Sweet! :) - chaparrito, Aug 11, 2010
Wow you really covered it All - readytodictate, Apr 9, 2013
Many of the things discussed in here no longer work on SD. CSS styles, for example, are ignored / stripped out of anwers when they are saved. - DilKen, Jun 15, 2015

69 Answers

1
vote

Thank you, thank you, thank you.

Thank You!

I Love it!

Gracias!

updated Apr 8, 2013
posted by LateToDinner
1
vote

This is great, Izan! grin I'm definitely bookmarking this thread (just like your 'colorful post' thread.) Thank you very much form the time to put all this detail in writing! smile

updated Apr 8, 2013
posted by chaparrito
0
votes

Heidi and a few of us are having trouble so maybe this will give us the good oil.

updated Aug 23, 2017
posted by ray76
0
votes

I will post an answer that just has the "code" for doing this. Note, however, that the "code" is basically the presence of four spaces at the beginning of a line so it doesn't really look like HTML code. You can click on edit and then copy and paste into a new answer to practice using this technique. Your answer will be published if you click submit at that point. There is no problem with that. And I think that is the only way you'll really be able to see the final result. Once you publish it and it gets posted to the SD hot questions board because an answer is added, you can edit it as many times as you want and it won't go to hot questions, but you'll be able to experiment to your heart's content.

==========================================================

This is an example of using a scroll bar to reveal a hint, show a hidden answer or explanation, etc. It could also be used to show how to say something in English or Spanish and then use the scroll bar to show how to say it in the other language. Sometimes members publish little challenges...how would you translate this, etc. This feature provides a way of doing that and providing the "answer key"

The technique is very simple. So simple, in fact, that some members have accidentally triggered this feature without knowing anything about it, and then thought there was something wrong with the system because it happened. ")

Here's how to do it. Start a line of text with 4 or more spaces. Keep typing (or holding down the space bar) and then type some more until the text starts to wrap onto the next line. (Write a very long sentence without hitting the space bar.)

If for some reason you want to have multiple lines of text, scrolling all together, you can hit the space bar at the end of one extra long line that it wrapping and then start typing another long line beginning with four spaces.

If you want to create multiple scroll bars with one line of text each you need to insert a line break < br > (without the spaces) on a blank line and then hit enter after the < br > The will insert a blank line between the line that just has < br > and your next line of text. Now, type 4 spaces and start another long line. As far as I know, you could repeat this process as long as you wanted to so you could have 10 or 20 questions / challenges / translations / whatever, each one with its own scroll bar.

I hope some of you find this technique useful and that you are able to creatively use this feature to help other members to learn English or Spanish or to just have some fun. Come to think of it, you could use this technique to show riddles in English or Spanish and then provide the answers to the riddles at the end of the scroll bar. smile

Click on the scroll bar for the hidden answer                                                                                            hidden answer.


Click on the scroll bar for the hidden answer                                                                                                            hidden answer.


Click on the scroll bar to review all the answers                                                                                                           answer 1.
Click on the scroll bar to review all the answers                                                                                                         answer 2.
Click on the scroll bar to review all the answers                                                                                                             answer 3.
Click on the scroll bar to review all the answers                                                                                                            answer 4.
updated Jul 18, 2017
edited by DilKen
posted by DilKen
0
votes

This one just has the code. If you want to experiment, click on edit, copy and paste to a new answer in this thread and then edit it so you get used to how it works.

=======================================================

Click on the scroll bar for the hidden answer 1                                              hidden answer 1.


Click on the scroll bar for the hidden answer 2                                               hidden answer 2.


Click on the scroll bar to review all the answers                                          answer 1.
Click on the scroll bar to review all the answers                                          answer 2.
Click on the scroll bar to review all the answers                                          answer 3.
Click on the scroll bar to review all the answers                                          answer 4.
updated Jul 15, 2017
posted by DilKen
0
votes

Sometimes you might want to list some things using a different font to call attention to them. Just use 4 spaces prior to typing actual characters on each new line.

This is text after 4 spaces  
This is more text after 4 spaces  

Now here is a line of text with no spaces
Here is a line with 4 space but it is not in the new font because there is no blank line following the line that did not use 4 spaces.

Here is a line of text with 4 spaces, This time I put a blank line before it.  As you can see, a funny thing happens when you have a line beginning with 4 spaces that is quite long. Rather than wrapping the text as usual, a scroll box is used to see the rest of the text.   Who knows, someone might want to use this so the reader has to use the scroll box to reveal a hidden clue, or a hidden answer.  
Here is a line after spaces without a blank line after the long line.  

Here is a line after 4 spaces after a blank line.  


Here is a line after 4 spaces after a line with a line break < b >  


Please scroll to see the answer to the question.  Are you scrolling yet.  Why not.  I think it will work.  Here's a bunch of spaces                                       did the spaces get eliminated?  I hope not.                                                                                                                            

Are we having fun yet?

Please scroll to the the explanation of this joke..............................................................................the lady wanted to sell her baby!  She said the guy would make a great father. smile
updated Jul 15, 2017
edited by DilKen
posted by DilKen
0
votes

This is some large purple text.

This is some smaller red text.

Smaller pink text

how about orange

and green

yellow

blue

jade

cyan

crimson

gold

lime

turquoise

navy blue

dark green that's really a darker red

magenta

khaki

fuchsia

violet

coral

capri

aqua

avocado

claret

cornflower blue

plum

grey

burnt orange

teal

updated Jun 4, 2015
edited by ray76
posted by rac1
jejejeje Ok, so now we know if you want a darker red....type in, dark green. - rac1, Jun 3, 2015
0
votes

Great job! wink

updated Jun 5, 2013
posted by 0080b918
0
votes

This is great Ira. As usual, it looks like you put a lot of time and energy into this project! smile

updated Apr 8, 2013
posted by Nicole-B