If you are describing something complex, there is a risk that your article can become a wall of text
The answer is often use images!
As you are more than likely describing some kind of process, the best picture will be a screen shot.
However, you don't want to snapshot your entire three monitors, you need to take a specific screen region.
Gnome Shell Screenshot Page Section¶
In Gnome Shell, you simply hit
[Shift]+[PrtScn] which makes your cursor into a cross.
You now draw a box with this cross and it is taken as a picture and saved into your
~/Pictures directory with a name like
Screenshot from 2018-01-31 09-28-45.png
Storing Images in the Handbook Filesystem¶
Your images should be stored in a folder with the same name as the article (without the
.md) they are being used in, but with
So for example in this article, the folder name is
To embed an image,First of all, create a sub folder with the same name as the
.md file you are editing, in the same directory as the
.md file and with the suffix
For example, when editing the file:
We would make a folder called
In this directory, you should put all the images for that post.
Then, to include the image in the post, you need to do as follows:
In the markdown file
The folder name, without a
/ in front, and then the image file name.
The text in the square brackets is the "alt text" for the image which is displayed if the image itself doesn't load for any reason.
The syntax for images is basically the same as the syntax for links, but with an
! at the start of the line