diff --git a/scripts/word2md.js b/scripts/word2md.js
deleted file mode 100644
index 4804a9f0563..00000000000
--- a/scripts/word2md.js
+++ /dev/null
@@ -1,245 +0,0 @@
-// word2md - Word to Markdown conversion tool
-//
-// word2md converts a Microsoft Word document to Markdown formatted text. The tool uses the
-// Word Automation APIs to start an instance of Word and access the contents of the document
-// being converted. The tool must be run using the cscript.exe script host and requires Word
-// to be installed on the target machine. The name of the document to convert must be specified
-// as a command line argument and the resulting Markdown is written to standard output. The
-// tool recognizes the specific Word styles used in the TypeScript Language Specification.
-var sys = (function () {
-    var fileStream = new ActiveXObject("ADODB.Stream");
-    fileStream.Type = 2 /*text*/;
-    var binaryStream = new ActiveXObject("ADODB.Stream");
-    binaryStream.Type = 1 /*binary*/;
-    var args = [];
-    for (var i = 0; i < WScript.Arguments.length; i++) {
-        args[i] = WScript.Arguments.Item(i);
-    }
-    return {
-        args: args,
-        createObject: function (typeName) { return new ActiveXObject(typeName); },
-        write: function (s) {
-            WScript.StdOut.Write(s);
-        },
-        writeFile: function (fileName, data) {
-            fileStream.Open();
-            binaryStream.Open();
-            try {
-                // Write characters in UTF-8 encoding
-                fileStream.Charset = "utf-8";
-                fileStream.WriteText(data);
-                // We don't want the BOM, skip it by setting the starting location to 3 (size of BOM).
-                fileStream.Position = 3;
-                fileStream.CopyTo(binaryStream);
-                binaryStream.SaveToFile(fileName, 2 /*overwrite*/);
-            }
-            finally {
-                binaryStream.Close();
-                fileStream.Close();
-            }
-        }
-    };
-})();
-function convertDocumentToMarkdown(doc) {
-    var result = "";
-    var lastStyle;
-    var lastInTable;
-    var tableColumnCount;
-    var tableCellIndex;
-    var columnAlignment = [];
-    var imageCount = 0;
-    function setProperties(target, properties) {
-        for (var name in properties) {
-            if (properties.hasOwnProperty(name)) {
-                var value = properties[name];
-                if (typeof value === "object") {
-                    setProperties(target[name], value);
-                }
-                else {
-                    target[name] = value;
-                }
-            }
-        }
-    }
-    function findReplace(findText, findOptions, replaceText, replaceOptions) {
-        var find = doc.range().find;
-        find.clearFormatting();
-        setProperties(find, findOptions);
-        var replace = find.replacement;
-        replace.clearFormatting();
-        setProperties(replace, replaceOptions);
-        find.execute(findText, false, false, false, false, false, true, 0, true, replaceText, 2);
-    }
-    function fixHyperlinks() {
-        var count = doc.hyperlinks.count;
-        for (var i = 0; i < count; i++) {
-            var hyperlink = doc.hyperlinks.item(i + 1);
-            var address = hyperlink.address;
-            if (address && address.length > 0) {
-                var textToDisplay = hyperlink.textToDisplay;
-                hyperlink.textToDisplay = "[" + textToDisplay + "](" + address + ")";
-            }
-        }
-    }
-    function write(s) {
-        result += s;
-    }
-    function writeTableHeader() {
-        for (var i = 0; i < tableColumnCount - 1; i++) {
-            switch (columnAlignment[i]) {
-                case 1:
-                    write("|:---:");
-                    break;
-                case 2:
-                    write("|---:");
-                    break;
-                default:
-                    write("|---");
-            }
-        }
-        write("|\n");
-    }
-    function trimEndFormattingMarks(text) {
-        var i = text.length;
-        while (i > 0 && text.charCodeAt(i - 1) < 0x20)
-            i--;
-        return text.substr(0, i);
-    }
-    function writeBlockEnd() {
-        switch (lastStyle) {
-            case "Code":
-                write("```\n\n");
-                break;
-            case "List Paragraph":
-            case "Table":
-            case "TOC":
-                write("\n");
-                break;
-        }
-    }
-    function writeParagraph(p) {
-        var range = p.range;
-        var text = range.text;
-        var style = p.style.nameLocal;
-        var inTable = range.tables.count > 0;
-        var level = 1;
-        var sectionBreak = text.indexOf("\x0C") >= 0;
-        text = trimEndFormattingMarks(text);
-        if (text === "/") {
-            range.textRetrievalMode.includeHiddenText = true;
-            var fullText = range.text;
-            range.textRetrievalMode.includeHiddenText = false;
-            if (text !== fullText) {
-                text = "&emsp;&emsp;" + fullText.substr(1);
-            }
-        }
-        if (inTable) {
-            style = "Table";
-        }
-        else if (style.match(/\s\d$/)) {
-            level = +style.substr(style.length - 1);
-            style = style.substr(0, style.length - 2);
-        }
-        if (lastStyle && style !== lastStyle) {
-            writeBlockEnd();
-        }
-        switch (style) {
-            case "Heading":
-            case "Appendix":
-                var section = range.listFormat.listString;
-                write("####".substr(0, level) + ' <a name="' + section + '"/>' + section + " " + text + "\n\n");
-                break;
-            case "Normal":
-                if (text.length) {
-                    write(text + "\n\n");
-                }
-                break;
-            case "List Paragraph":
-                write("        ".substr(0, range.listFormat.listLevelNumber * 2 - 2) + "* " + text + "\n");
-                break;
-            case "Grammar":
-                write("&emsp;&emsp;" + text.replace(/\s\s\s/g, "&emsp;").replace(/\x0B/g, "  \n&emsp;&emsp;&emsp;") + "\n\n");
-                break;
-            case "Code":
-                if (lastStyle !== "Code") {
-                    write("```TypeScript\n");
-                }
-                else {
-                    write("\n");
-                }
-                write(text.replace(/\x0B/g, "  \n") + "\n");
-                break;
-            case "Table":
-                if (!lastInTable) {
-                    tableColumnCount = range.tables.item(1).columns.count + 1;
-                    tableCellIndex = 0;
-                }
-                if (tableCellIndex < tableColumnCount) {
-                    columnAlignment[tableCellIndex] = p.alignment;
-                }
-                write("|" + text);
-                tableCellIndex++;
-                if (tableCellIndex % tableColumnCount === 0) {
-                    write("\n");
-                    if (tableCellIndex === tableColumnCount) {
-                        writeTableHeader();
-                    }
-                }
-                break;
-            case "TOC Heading":
-                write("## " + text + "\n\n");
-                break;
-            case "TOC":
-                var strings = text.split("\t");
-                write("        ".substr(0, level * 2 - 2) + "* [" + strings[0] + " " + strings[1] + "](#" + strings[0] + ")\n");
-                break;
-        }
-        if (sectionBreak) {
-            write("<br/>\n\n");
-        }
-        lastStyle = style;
-        lastInTable = inTable;
-    }
-    function writeDocument() {
-        var title = doc.builtInDocumentProperties.item(1) + "";
-        if (title.length) {
-            write("# " + title + "\n\n");
-        }
-        for (var p = doc.paragraphs.first; p; p = p.next()) {
-            writeParagraph(p);
-        }
-        writeBlockEnd();
-    }
-    findReplace("<", {}, "&lt;", {});
-    findReplace("&lt;", { style: "Code" }, "<", {});
-    findReplace("&lt;", { style: "Code Fragment" }, "<", {});
-    findReplace("&lt;", { style: "Terminal" }, "<", {});
-    findReplace("", { font: { subscript: true } }, "<sub>^&</sub>", { font: { subscript: false } });
-    findReplace("", { style: "Code Fragment" }, "`^&`", { style: -66 /* default font */ });
-    findReplace("", { style: "Production" }, "*^&*", { style: -66 /* default font */ });
-    findReplace("", { style: "Terminal" }, "`^&`", { style: -66 /* default font */ });
-    findReplace("", { font: { bold: true, italic: true } }, "***^&***", { font: { bold: false, italic: false } });
-    findReplace("", { font: { italic: true } }, "*^&*", { font: { italic: false } });
-    doc.fields.toggleShowCodes();
-    findReplace("^19 REF", {}, "[^&](#^&)", {});
-    doc.fields.toggleShowCodes();
-    fixHyperlinks();
-    writeDocument();
-    result = result.replace(/\x85/g, "\u2026");
-    result = result.replace(/\x96/g, "\u2013");
-    result = result.replace(/\x97/g, "\u2014");
-    return result;
-}
-function main(args) {
-    if (args.length !== 2) {
-        sys.write("Syntax: word2md <inputfile> <outputfile>\n");
-        return;
-    }
-    var app = sys.createObject("Word.Application");
-    var doc = app.documents.open(args[0]);
-    sys.writeFile(args[1], convertDocumentToMarkdown(doc));
-    doc.close(false);
-    app.quit();
-}
-main(sys.args);
-//# sourceMappingURL=file:///c:/ts/scripts/word2md.js.map
\ No newline at end of file
diff --git a/scripts/word2md.ts b/scripts/word2md.ts
index 62582992c49..f602c700ff9 100644
--- a/scripts/word2md.ts
+++ b/scripts/word2md.ts
@@ -270,6 +270,10 @@ function convertDocumentToMarkdown(doc: Word.Document): string {
 
         text = trimEndFormattingMarks(text);
         if (text === "/") {
+            // An inline image shows up in the text as a "/". When we see a paragraph
+            // consisting of nothing but "/", we check to see if the paragraph contains
+            // hidden text and, if so, emit that instead. The hidden text is assumed to
+            // contain an appropriate markdown image link.
             range.textRetrievalMode.includeHiddenText = true;
             var fullText = range.text;
             range.textRetrievalMode.includeHiddenText = false;