TUTORIAL: how to format your question with markup

Oleg Komarov on 6 Aug 2011
Latest activity Reply by fatih erkin on 8 Mar 2023

[INDEX]
--------------------------------------------------------------------------------------------------------------------------------------
[MOTIVATION]
Why should we use markups in the body of our questions?
The answer is a question: which of the two versions is more likely to be understood in a glimpse and has more chances to be answered by our readers?
.
< Consider the following question >
I have a vector of weights W=[10,20,30,50,23434,1,2.4,2] and a matrix A=rand(100,8) and I would like to find the row-wise weighted sum of A. I am proceeding in the following way: B=zeros(size(A)); for c=1:numel(W) B(:,c)=A(:,c)*W(c); end B=sum(B,2); Somehow I get huge numbers can you please help?
.
< Now, consider its formatted version >
I have a vector of weights W = [10,20,30,50,23434,1,2.4,2] and a matrix A = rand(100,8) and I would like to find the row-wise weighted sum of A.
I am proceeding in the following way:
B = zeros(size(A));
for c = 1:numel(W)
B(:,c) = A(:,c)*W(c);
end
B = sum(B,2);
--------------------------------------------------------------------------------------------------------------------------------------
[AKNOWLEDGMENTS]
In alphabetical order by nickname, thanks for their suggestions to:
Walter Roberson
--------------------------------------------------------------------------------------------------------------------------------------
[LOG]
• 06 Aug 2011, 13:17 BST - created and added boldface.gif
• 06 Aug 2011, 14:59 BST - added italic.gif
• 06 Aug 2011, 18:58 BST - added index section
• 07 Aug 2011, 00:03 BST - added code.gif and tutorial series section
• 07 Aug 2011, 01:50 BST - added monospaced.gif, numlist.gif, bullist.gif and hyperlink.gif
• 13 Aug 2011, 14:27 BST - added motivation section
• 18 Aug 2011, 01:44 BST - added aknowledgments section and link to wish-list
--------------------------------------------------------------------------------------------------------------------------------------
[TUTORIAL Series]
Do not forget to read the Markup help (located on the top-right corner of the Body pane)
Vote on Wish-list for MATLAB Answer sections my post if you think that a tutorial section on top of Answers could be useful.

fatih erkin on 8 Mar 2023
thanks
Walter Roberson on 16 Apr 2018
Image Analyst on 13 Aug 2016
To insert an image into the body of your post, click this icon:
and either browse to a file on your computer, or specify a URL of an image on the web.
You might find it easy to use http://snag.gy. You can just type alt-PrintScreen (in Windows) to capture the active window into the clipboard. Then go to this web site and type control-v to paste it in. You can then crop if it you want. It gives you a URL that you can then paste into the URL field you see when you click the green and brown frame icon:
You can also use the paper clip icon to attach an image file to your post, but it will not be displayed. It will appear as a filename beneath your text. We would then have to right click that filename and save it to our computer, and then open the image in MATLAB or some other image file viewer. This is less convenient for readers because they can't see your picture immediately.
madhan ravi on 11 Nov 2018
Thank you sir Image Analyst it turned out only jpg format can be viewed directly
Image Analyst on 11 Nov 2018
After you click Insert Image, try putting a blank line before the < < and a blank line after the > >.
madhan ravi on 11 Nov 2018
Click the green and brown frame icon to insert the image into the body of the message.
I did it but still it displays as a file , does it have to do anything with the image format because it's a screenshot?
Image Analyst on 11 Nov 2018
Click the green and brown frame icon to insert the image into the body of the message. The image will be displayed.
Click the paper clip icon to attach the image as a file. If you do this only the filename will show up and the image will not be displayed.
madhan ravi on 11 Nov 2018
@sir Image Analyst how to attach an image without being an attachment instead it can be an image so that the reader doesn't have to click the attachment to view the content?
chocho on 23 Feb 2017
thanks Image Analyst bro , next time i will follow
Ryan on 18 Oct 2012
@Elige: Yes... the first two used tinypic the latter used uploadhouse. I uploaded the first two .gif's to uploadhouse for you.
Sean de Wolski on 18 Oct 2012
Me too.
Jan on 27 Nov 2011
Dear Oleg: Thanks. I really appreciate this thread.
Unfortunately newcomers in this forum do not read the 20 most voted threads before they ask an own question.
Oleg Komarov on 3 Nov 2011
Very busy this period, as you may have noticed I almost disappeared from the forum. I am moving to London (looking for accomodation...it's a nightmare here), starting a PhD and I need first to finalize the work in progress pages about my dissertation.
Walter Roberson on 31 Oct 2011
Oleg, perhaps you could record one of these for inserting an image?
Walter Roberson on 18 Aug 2011
Perhaps a note could be added somewhere that if you want a < and > that is *not* in a Code section, then either there must be whitespace after the < or before the >, or else < and > must be coded.
Also, perhaps a note that none of these formatting commands apply in Comments (distinguished, of course, from comments in the code).
Oh yeah, and I'd warn about the massive bug if you have a quoted line in a Comment or edit an Answer that contains such a line. :( :(
Walter Roberson on 13 Aug 2011
With Motivation of course comes http://en.wikipedia.org/wiki/Method_acting ;-)
Oleg Komarov on 8 Aug 2011
Jan on 7 Aug 2011
Ouch. I thought of posting a realtime animated GIF of the latency effects in my moaning thread. But unfortunately my computer is loaded by 100% during the keystrokes and the screen recorder is blocked. Then I take a movie with a camera - but it looks so slow, that only patient users believe, that it is an animation at all. :-(
I never use the buttons but type the format characters directly - this works in an external editor also...
Oleg Komarov on 7 Aug 2011
CODE
Stephen23 on 12 Jun 2018
@Trude Mashburn: I just checked your question, and none of the code text has been indented.
1. Select the code text
2. Click the {} Code button
3. Ensure that there is a trailing empty line
4. Check the formatting in the preview pane, make changes as required.
5. Click Submit to save the new formatting.
An alternative to using the {} Code button is to simply put two space characters at the start of each code line.
Trude Mashburn on 12 Jun 2018
I updated my question and content based on your instructions. However, the code is not showing in this application as I had it formatted.
Image Analyst on 10 May 2014
To do this highlight your code in the MATLAB editor (for example type "Ctrl a" to select all the text in the editor), then type "Ctrl i". This "fixes/standardizes" your indentations. Then , paste your code in, and then click the "{} Code" icon. DO NOT CLICK "{} Code" before you paste in your code. That will not work.
Walter Roberson on 10 Aug 2011
Note: the code formatting mode will last to the first empty line, even if there are no spaces at the beginning of the lines in the block.
Oleg Komarov on 7 Aug 2011
Walter Roberson on 7 Aug 2011
Simple hyperlinks are not converted automatically by the site: that is being done by browsers.
Note: ensure that there is no whitespace space immediately after the < or immediately before the > or else the link will not be created.
Note: there must be whitespace (or beginning of line) immediately before the < or else the link will not be created. In particular, some people like to put links in brackets such as (<some link or other>) and that will not work because there must be a space before the < .
Oleg Komarov on 7 Aug 2011
BULLETED LIST
Walter Roberson on 12 Aug 2011
Note: the * must be after a "real" line break, where carriage return was typed at the end of the previous line; it is not sufficient to put it at what looks like the beginning of a line, if the line has been automatically wrapped down from the previous line.
Walter Roberson on 8 Aug 2011
Note: there must be a space after the *
Walter Roberson on 7 Aug 2011
Note: there must be a blank line before and after the * list.
Oleg Komarov on 7 Aug 2011
NUMBERED LIST
Walter Roberson on 12 Aug 2011
Note: the numbering sequence restarts at each empty line, so do _not_ put blank lines between the portions.
Note: the # must be after a "real" line break, where carriage return was typed at the end of the previous line; it is not sufficient to put it at what looks like the beginning of a line, if the line has been automatically wrapped down from the previous line.
Walter Roberson on 8 Aug 2011
Note: there must be a space after the #
Walter Roberson on 7 Aug 2011
Note: here must be a blank line before and after the # list
Oleg Komarov on 7 Aug 2011
MONOSPACED
Walter Roberson on 12 Aug 2011
Note: the monospaced mode only works between pairs of bars in the same paragraph. If you highlight several paragraphs (with empty lines between them) and click on the monospace button, although an bar will be put on the first line and last line of the selection, the monospace will "break" because of the empty lines.
Oleg Komarov on 6 Aug 2011
ITALIC
Walter Roberson on 10 Aug 2011
Note: the italic mode only works between pairs of underscores in the same paragraph. If you highlight several paragraphs (with empty lines between them) and click on the Italic button, although an underscore will be put on the first line and last line of the selection, the italics will "break" because of the empty lines.
Oleg Komarov on 6 Aug 2011
BOLDFACE
Walter Roberson on 10 Aug 2011
Note: the bold mode only works between pairs of * in the same paragraph. If you highlight several paragraphs (with empty lines between them) and click on the Bold button, although an * will be put on the first line and last line of the selection, the bold will "break" because of the empty lines.
Daniel Shub on 6 Aug 2011
Poor Jan, if the Mathworks folks see this, they are never going to deal with the keyboard latency.
Fangjun Jiang on 6 Aug 2011
I see. My experience on all those types of image files is all static pictures. Apparently GIF file supports animation too.
Please, add the illustration for formatting code. Should be just similar. But you know, that is the most occurred problem.
Oleg Komarov on 6 Aug 2011
I used Camtasia Studio to record the desktop, edit the image and produce the gif which I then uploaded to a repository
Fangjun Jiang on 6 Aug 2011
Well done, Oleg! How did you do it?