diff --git a/README.md b/README.md
index 672788f..5982a82 100755
--- a/README.md
+++ b/README.md
@@ -35,6 +35,18 @@ A collection of useful scripts, tutorials, and other Python-related things
- Sorting CSV files using the Python csv module [[IPython nb](http://nbviewer.ipython.org/github/rasbt/python_reference/blob/master/tutorials/sorting_csvs.ipynb)]
+
+
+
+###// Python and the web
+
+- Creating a table of contents with internal links in IPython Notebooks and Markdown documents [[IPython nb](http://nbviewer.ipython.org/github/rasbt/python_reference/blob/master/tutorials/table_of_contents_ipython.ipynb)]
+
+- 5 simple steps for converting Markdown documents into HTML and adding Python syntax highlighting [[Markdown](./tutorials/markdown_syntax_highlighting/README.md)]
+
+
+
+
###// benchmarks
@@ -51,9 +63,9 @@ GitHub repository [One-Python-benchmark-per-day](https://github.com/rasbt/One-Py
-###// other
-- Creating a table of contents with internal links in IPython Notebooks and Markdown documents [[IPython nb](http://nbviewer.ipython.org/github/rasbt/python_reference/blob/master/tutorials/table_of_contents_ipython.ipynb)]
+
+###// other
- Happy Mother's Day [[IPython nb](http://nbviewer.ipython.org/github/rasbt/python_reference/blob/master/funstuff/happy_mothers_day.ipynb?create=1)]
diff --git a/tutorials/markdown_syntax_highlighting/README.md b/tutorials/markdown_syntax_highlighting/README.md
new file mode 100644
index 0000000..424bdd8
--- /dev/null
+++ b/tutorials/markdown_syntax_highlighting/README.md
@@ -0,0 +1,176 @@
+[Sebastian Raschka](http://sebastianraschka.com)
+
+last updated: 05/28/2014
+
+
+I would be happy to hear your comments and suggestions.
+Please feel free to drop me a note via
+[twitter](https://twitter.com/rasbt), [email](mailto:bluewoodtree@gmail.com), or [google+](https://plus.google.com/118404394130788869227).
+
+
+
+# 5 simple steps for converting Markdown documents into HTML and adding Python syntax highlighting
+
+
+
+
+In this little tutorial, I want to show you in 5 simple steps how easy it is to add code syntax highlighting to your blog articles.
+
+There are more sophisticated approaches using static site generators, e.g., [nikola](https://github.com/getnikola/nikola), but the focus here is to give you the brief introduction of how it generally works.
+
+
+All the files I will be using as examples in this tutorial can be download from the GitHub repository [/rasbt/python_reference/tutorials/markdown_syntax_highlighting](https://github.com/rasbt/python_reference/tutorials/markdown_syntax_highlighting)
+
+
+
+
+##1 - Installing packages
+
+The two packages that we will use are
+
+- [Python-Markdown](http://pythonhosted.org/Markdown/)
+
+- [Pygments](http://pygments.org)
+
+Just as the name suggests, Python-Markdown is the Python package that we will use for the Markdown to HTML conversion.
+The second library, Pygments, will be used to add the syntax highlighting to the code blocks.
+Conveniently, both libraries can be installed via `pip`:
+
+
+ pip install markdown
+
+and
+
+ pip install Pygments
+
+
+(For alternative ways to install the Python-Markdown package, please see [the
+documentation](http://pythonhosted.org/Markdown/install.html))
+
+
+
+
+
+##2 - Writing a Markdown document
+
+Now, let us compose a simple Markdown document including some Python code blocks in any/our favorite Markdown editor.
+
+
+--> [**some_markdown.md**](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/some_markdown.md)
+
+
+
+
+##This is a test
+
+Code blocks must be indented by 4 whitespaces.
+Python-Markdown has a auto-guess function which works
+pretty well:
+
+ print("Hello, World")
+ # some comment
+ for letter in "this is a test":
+ print(letter)
+
+In cases where Python-Markdown has problems figuring out which
+programming language we use, we can also add the language-tag
+explicitly. One way to do this would be:
+
+ :::python
+ print("Hello, World")
+
+or we can highlight certain lines to
+draw the reader's attention:
+
+ :::python hl_lines="1 5"
+ print("highlight me!")
+ # but not me!
+ for letter in "this is a test":
+ print(letter)
+ # I want to be highlighted, too!
+
+
+
+
+
+
+
+
+## 3 - Converting the Markdown document to HTML
+
+
+After we created our Markdown document, we are going to use Python-Markdown directly from the command line to convert it into an HTML document.
+
+Note that we can also import Python-Markdown as a module in our Python scripts, and it comes with a rich repertory of different functions, which are [listed in the library reference](https://pythonhosted.org/Markdown/reference.html).
+
+The basic command line usage to convert a Markdown document into HTML would be:
+
+ python -m markdown input.md > output.html
+
+However, since we want to have syntax highlighting for our Python code, we will use Python-Markdown's [CodeHilite extension](http://pythonhosted.org/Markdown/extensions/code_hilite.html) by providing an additional `-x codehilite` argument on the command line:
+
+
+ python -m markdown -x codehilite some_markdown.md > body.html
+
+This will create the HTML body with our Markdown code converted to HTML with the Python code blocks annotated for the syntax highlighting.
+
+
+
+
+
+##4 - Generating the CSS
+
+If we open the [**body.html**](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/body.html) file now, which we have created in the previous section, we will notice that it doesn't have the Python code colored yet.
+
+
+
+What is missing is the CSS code for adding the colors to our annotated Python code block. But we can simply create such a CSS file via `Pygments` from the command line.
+
+ pygmentize -S default -f html > codehilite.css
+
+Note that we usually only need to create the [**codehilite.css**](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/codehilite.css) file once and insert a link in all our HTML files that we created via Python-Markdown to get the syntax coloring
+
+
+
+
+
+
+## 5 - Insert into your HTML body
+
+
+In order to include a link to the [codehilite.css](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/codehilite.css) file for syntax coloring in our converted HTML file, we have to add the following line to the header section.
+
+
+
+``
+
+
+Now, we can insert the HTML body ([body.html](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/body.html)), which was created from our Markdown document, directly into our final HTML file (e.g., our blog article template).
+
+
+[**template.html**](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/template.html):
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <-- converted HTML contents go here
+
+
+
+
+
+
+If we open our [**final.html**](https://github.com/rasbt/python_reference/blob/master/tutorials/markdown_syntax_highlighting/template.html) file in our web browser now, we can the pretty Python syntax highlighting.
+
+
+
+
diff --git a/tutorials/markdown_syntax_highlighting/body.html b/tutorials/markdown_syntax_highlighting/body.html
new file mode 100644
index 0000000..e768c67
--- /dev/null
+++ b/tutorials/markdown_syntax_highlighting/body.html
@@ -0,0 +1,26 @@
+
This is a test
+
Code blocks must be indented by 4 whitespaces.
+Python-Markdown has a auto-guess function which works
+pretty well:
+
print("Hello, World")
+# some comment
+forletterin"this is a test":
+ print(letter)
+
+
+
+
In cases where Python-Markdown has problems figuring out which
+programming language we use, we can also add the language-tag
+explicitly. One way to do this would be:
+
print("Hello, World")
+
+
+
+
or we can highlight certain lines to
+draw the reader's attention:
+
print("highlight me!")
+# but not me!
+forletterin"this is a test":
+ print(letter)
+# I want to be highlighted, too!
+
Code blocks must be indented by 4 whitespaces.
+Python-Markdown has a auto-guess function which works
+pretty well:
+
print("Hello, World")
+# some comment
+forletterin"this is a test":
+ print(letter)
+
+
+
+
In cases where Python-Markdown has problems figuring out which
+programming language we use, we can also add the language-tag
+explicitly. One way to do this would be:
+
print("Hello, World")
+
+
+
+
or we can highlight certain lines to
+draw the reader's attention:
+
print("highlight me!")
+# but not me!
+forletterin"this is a test":
+ print(letter)
+# I want to be highlighted, too!
+
+
+
+
diff --git a/tutorials/markdown_syntax_highlighting/images/mk_syntax_body_html.png b/tutorials/markdown_syntax_highlighting/images/mk_syntax_body_html.png
new file mode 100644
index 0000000..3b3aab6
Binary files /dev/null and b/tutorials/markdown_syntax_highlighting/images/mk_syntax_body_html.png differ
diff --git a/tutorials/markdown_syntax_highlighting/images/mk_syntax_final_html.png b/tutorials/markdown_syntax_highlighting/images/mk_syntax_final_html.png
new file mode 100644
index 0000000..eeba886
Binary files /dev/null and b/tutorials/markdown_syntax_highlighting/images/mk_syntax_final_html.png differ
diff --git a/tutorials/markdown_syntax_highlighting/some_markdown.md b/tutorials/markdown_syntax_highlighting/some_markdown.md
new file mode 100644
index 0000000..44b0230
--- /dev/null
+++ b/tutorials/markdown_syntax_highlighting/some_markdown.md
@@ -0,0 +1,27 @@
+##This is a test
+
+Code blocks must be indented by 4 whitespaces.
+Python-Markdown has a auto-guess function which works
+pretty well:
+
+ print("Hello, World")
+ # some comment
+ for letter in "this is a test":
+ print(letter)
+
+In cases where Python-Markdown has problems figuring out which
+programming language we use, we can also add the language-tag
+explicitly. One way to do this would be:
+
+ :::python
+ print("Hello, World")
+
+or we can highlight certain lines to
+draw the reader's attention:
+
+ :::python hl_lines="1 5"
+ print("highlight me!")
+ # but not me!
+ for letter in "this is a test":
+ print(letter)
+ # I want to be highlighted, too!
\ No newline at end of file
diff --git a/tutorials/markdown_syntax_highlighting/template.html b/tutorials/markdown_syntax_highlighting/template.html
new file mode 100644
index 0000000..4e0f049
--- /dev/null
+++ b/tutorials/markdown_syntax_highlighting/template.html
@@ -0,0 +1,14 @@
+
+
+
+
+
+
+
+
+
+
+<-- converted HTML contents go here
+
+
+
\ No newline at end of file