Added markdown docs and identified a bug.

TODO/_current.md

@@ -1,5 +1,9 @@
 * Review doc mentions of view-process.
 
+# Markdown
+
+* Does not support paragraph in list items.
+
 # Documentation
 
 * Add build dependencies for each operating system on the main `README.md`.

examples/res/markdown/sample.md

@@ -15,6 +15,8 @@ Sample of other blocks items:
 Unordered lists:
 
 * Item 1
+
+  Is a paragraph item.
 * Item 2
 * Item 3
 

zero-ui/src/markdown.rs

@@ -1,5 +1,17 @@
 //! Markdown widget, properties and types.
 //!
+//! This widget displays [CommonMark] text, without support for HTML code yet .
+//!
+//! [CommonMark]: https://commonmark.org/
+//!
+//! ```
+//! # let _scope = zero_ui::APP.defaults(); let _ =
+//! zero_ui::markdown::Markdown! {
+//!     txt = "# Title\n\n- List item 1.\n- List item 2.";
+//! }
+//! # ;
+//! ```
+//! 
 //! # Full API
 //!
 //! See [`zero_ui_wgt_markdown`] for the full widget API.