Readme: add usage examples

Author: stscoundrel

README.md

@@ -19,6 +19,43 @@ As Maven dependency.
 
 For alternative install methods, see the [Maven Central Repo](https://search.maven.org/artifact/io.github.stscoundrel/old-norse-dictionary)
 
+### Usage
+
+The dictionary comes in two variants:
+- Markup dictionary has HTML markup `<i>` and `<b>` to match look of the original book.
+- No-markup version has the same content without any additional formatting tags.
+
+Dictionary defaults to "no markup".
+
+```scala
+
+import io.github.stscoundrel.oldnorsedictionary
+
+val dictionary = new Dictionary()
+
+// Both dictionaries return entries that consist of headword and definitions list.
+val noMarkupResult = dictionary.getNoMarkupDictionary() // also aliased as getDictionary()
+val markupResult = dictionary.getMarkupDictionary()
+
+// Headwords wont differ between dictionaries.
+println(noMarkupResult(1989).headword)  // át-frekr
+println(markupResult(1989).headword)    // át-frekr
+
+// But definition markup does differ.
+println(noMarkupResult(14).definitions(0))   // adj. <i>greedy, voracious,</i> Hkv. 2. 41.
+println(markupResult(14).definitions(0))     // adj. greedy, voracious, Hkv. 2. 41.
+
+```
+
+Individual words are returned in format of:
+
+```scala
+{
+    headword: String
+    definitions: Array[String]
+}
+```
+
 ### About Cleasby & Vigfusson Dictionary
 
 "Icelandic-English" dictionary was started by Richard Cleasby and finished by Gudbrand Vigfusson. It was published in 1874, which leads to there being many public domain versions of the book available.