Click here to view the video version of this walkthrough.

Start by joining BimlScript.com.

Log in to your account.

Click the Contribute link on the main menu.

You are now on the create walkthrough page.

The first thing you will notice is the Upload photo button. This allows you to upload photos to use in your Walkthrough. This functionality is further explained toward the end of this walkthrough.

Fill in the Title, Tags, Summary, Topics, and Versions fields.

The Title field should be as concise as possible but as descriptive as necessary.

Tags are separated by whitespace. Multiword Tags are to be enclosed in quotations marks.

The Summary field should give the reader a high-level overview of the Walkthrough’s Contents. Keep in mind that part of the summary will be used on your walkthrough’s thumbnail on the Browse page. It may even be featured on the front page of BimlScript.com. You may wish to fill this field in once you have finished writing the walkthrough.

Select all the Topics related to your walkthrough. You should always select at least one Topic.

Fill in the Content Field.

You will notice that BimlScript.com uses a markdown editor for a Walkthrough’s main Content area. I’ll provide a brief description of markdown features here. A full description of available markdown features can be found in the Markdown Syntax Guide.

The content editor provides buttons to automatically insert the most commonly used Markdown syntax features.

Clicking one of those buttons will generate the necessary markdown to get the formatting that you want. The cursor will be put in the correct place. If you click one of these buttons while you have text highlighted in the Content area, then the text will be surrounded with the correct markdown tags.

At the top of the page, you’ll notice that there is an area for uploading photos. To upload a photo, simply drag and drop your photo(s) onto the upload button, or click the upload button to open a file dialog box.

The selected images will immediately begin uploading.

You can cancel the upload if you wish. Once the photos finish uploading, they will appear in a photo slide show area.

You can navigate through the photos by either clicking the Prev and Next buttons, or you can simply click the image to advance to the next photo. Click the Paste button to place the markdown image tag into the Content text area.

The content editor will automatically insert the markdown text to display the image in your walkthrough. Feel free to change the alternative and title text. Use the Code button to put in BimlScript code snippets. The best way to do this is to write all the necessary code, and then highlight the entire thing, and then click the button. It should look like the following when you’re done.

Once the walkthrough is created, the Biml code will look like this.

Once you are finished creating your walkthrough, you can click the Preview button to view your Walkthrough without publishing it. Alternatively, you can click the Publish button to make it immediately available for the world to see. Remember, you can always edit your walkthroughs or unpublish them.