docs and refactor

docs/widgets/markdown.md

@@ -0,0 +1,40 @@
+# Markdown
+
+A widget to display a Markdown document.
+
+- [x] Focusable
+- [ ] Container
+
+
+!!! tip
+
+    See [MarkdownViewer](./markdown_viewer.md) for a widget that adds additional features such as a Table of Contents.
+
+## Example
+
+The following example displays Markdown from a string.
+
+=== "Output"
+
+    ```{.textual path="docs/examples/widgets/markdown.py"}
+    ```
+
+=== "markdown.py"
+
+    ~~~python
+    --8<-- "docs/examples/widgets/markdown.py"
+    ~~~
+
+## Messages
+
+### ::: textual.widgets.Markdown.TOCUpdated
+
+### ::: textual.widgets.Markdown.TOCSelected
+
+### ::: textual.widgets.Markdown.LinkClicked
+
+
+## See Also
+
+* [Markdown][textual.widgets.Markdown] code reference
+* [MarkdownViewer][textual.widgets.MarkdownViewer] code reference