Formatting with Markdown
-
A Former User last edited by
Thanks ruario, that's very useful indeed, but I do still have to ask the obvious question.
Why on earth can't we have a forum where you just type what you want into your posts, and there are buttons at the top of the text input field for doing things like inserting links or images and formatting text, just like every other forum I use on the web has?!
The average non-technical user of this forum would have little or no idea about how to do all this, and more to the point would have no idea why they should have to!
-
ruario last edited by
The average non-technical user of this forum would have little or no idea about how to do all this, and more to the point would have no idea why they should have to!
More often than not they don't have to. You can almost always just get away with typing your question with no formatting.
Additionally, one of the nice things about Markdown is that many common plain conventions naturally translate. For example, most people who try to make lists, bullet them with * and it just works.
-
joshl last edited by
You can provide example computer code (monospaced) by enclosing the text in grave accents (backticks):
...If anybody doesn't know where to find that on their keyboard,
.
-
ruario last edited by
If anybody doesn't know where to find that on their keyboard
That very much depends on your keyboard layout. On a Norwegian PC layout for example it is to the left of backspace but you need to press ⇧ Shift and it acts as a dead key.
-
joshl last edited by
You can insert images like this:
![opera logo](https://d2jc9zwbrclgz3.cloudfront.net/forums/7ac1a402f7/themes/opera/design/static/css/img/opera-software-logo.png)
The words in brackets won't be displayed as a tooltip - they only be displayed if the page has failed to load the image
(this stuff is used by screen readers)
. To make a tooltip, use this syntax:![screenreader text](the_link "your tooltip text")
Heed the space you'll need between the link and the tooltip element.
The tooltip element is placed within the same parentheses as the link to your image.You can tooltip "texted" links the same way:
[your visible text](your_link "the tooltip that pops up on a hover")
-
ruario last edited by
The words in brackets won't be displayed as a tooltip
Yep I know. I am intentionally providing only the most basic versions of everything to keep the guide simple. Someone, who knows Markdown (or HTML) can easily add them.
-
joshl last edited by
I am intentionally providing only the most basic...
...then the nerd fills in the gaps.
Show if it's possible to do quotes within quotes - with Markdown.
(It's quite frequent a situation here on the forums, isn't it?) -
ruario last edited by
I am intentionally providing only the most basic...
Show if it's possible to do quotes within quotes - with Markdown.
You mean like that?
> > I am intentionally providing only the most basic... > > Show if it's possible to do quotes within quotes - **with Markdown**.
-
joshl last edited by
Yes, I checked - it worked as you showed.
So, to make a second (or further) level quote, you need to put a space between the angulars?
The autoquoting doesn't seem to do that*:rolleyes:*
Speaking of basics - you didn't even fancy to remember a simple linebreak. Right?
I saw a Markdown - or similar - being introduced on another site: the lines don't break there either*:D*
Unless...(your cue, sherlock;) -
ruario last edited by
If you want a line break you put two spaces and a carriage return and text will continue on the next line
Outputs
If you want a line break you put two spaces and a carriage return
and text will continue on the next line
This is all in the syntax guide by the way.
When you do want to insert a <br /> break tag using Markdown, you end a line with two or more spaces, then type return.
-
joshl last edited by
If you want a line break you put two spaces and a carriage return
and text will continue on the next lineIf you want a line break you put two spaces and a carriage return
and text will continue on the next line<abbr title="Something's wrong with your punctuation, by the way.">What is the output difference between that two spaces on one hand and twice clicking "Enter" on the other?</abbr>
None? -
ruario last edited by
What is the output difference between that two spaces on one hand and twice clicking "Enter" on the other? None?
Click enter twice would have given you an extra blank line in the output, i.e.
<p>
instead of a
If you want a line break you put two spaces and a carriage return and text will continue on the next line.
Outputs
If you want a line break you put two spaces and a carriage return
and text will continue on the next line.
If you want to start a new paragraph, use two carriage returns. The second paragraph begins here.
Outputs
If you want to start a new paragraph, use two carriage returns.
The second paragraph begins here.
-
joshl last edited by
Click enter twice would have given you an extra blank line in the output, i.e.
<p>
instead of aIt looks more like a 1.5 interval*:P*
-
A Former User last edited by
If you want a line break you put two spaces and a carriage return
and text will continue on the next lineOutputs
If you want a line break you put two spaces and a carriage return
and text will continue on the next lineThis is all in the syntax guide by the way.
When you do want to insert a <br /> break tag using Markdown, you end a line with two or more spaces, then type return.
A prime example of what I was saying earlier.
An average user will not know that, and will just type away, putting carriage returns in when they want a new paragraph, and instead will end up with a terrible mess and won't know why!
The carriage returns show OK in the input box.
Whatever happened to WYSIWYG!
-
ruario last edited by
Actually most people do not do that. How many people actually aim for output like yours? For clarity, people generally enter two lines when they want a new paragraph (to give a little spacing). So it is WYSIWYG for most people.
I honestly don't believe this is the problem you are making it out to be. Sure, there are a fair number of posts with some "mistakes" but it doesn't look any worse than any other random forum, despite the lack of formatting buttons. This is because those who care about formatting will notice and click on the "You may use Markdown in your reply." link. Those who don't care don't need such buttons.
Why on earth can't we have a forum where you just type what you want into your posts, and there are buttons at the top of the text input field for doing things like inserting links or images and formatting text, just like every other forum I use on the web has?!
Have you ever heard of Reddit? I would guess so, given they have 174 million users. Their comment box also uses Markdown and only includes a simple link to formatting help. Is it chaos? Yes! But not because of the formatting!
-
ruario last edited by
I decided to make this even simpler by adding a summary to the top (with tips). I expect most people could get by with just this and never need to scroll down into the details section.
-
ruario last edited by
Let me see if I have this right.
In order to make things italic, I need to do this
To put in a link to the Opera blogs, I could do this: http://blogs.opera.com/news/
or
I could do it like this: blogs
- it's easy
- it's clean
- it makes sense
-
joshl last edited by
Leushino, the thread is about formatting with the Markdown on these forums these days. HTML analogies are given for the reference. As long as everybody knows it's not executable to do italics with Markdown on these forums these days, today in this board you seem to be a bit off the topic.
-
Deleted User last edited by
Leushino, the thread is about formatting with the Markdown on these forums these days. HTML analogies are given for the reference. As long as everybody knows it's not executable to do italics with Markdown on these forums these days, today in this board you seem to be a bit off the topic.
He is just testing markdown, he is not off the topic.