Update Related Projects section to general Markdown Ecosystem section with references to more available plugins

Author: MeanderingProgrammer

README.md

@@ -147,11 +147,39 @@ have quite what I was looking for. In particular I wanted something that would
 disappear completely when editing a file and quickly render some style when viewing
 the file. Hence this plugin.
 
-# Related Projects
+# Markdown Ecosystem
+
+There are many `markdown` plugins that specialize in different aspects of interacting
+with `markdown` files. This plugin specializes in rendering the buffer inside of
+Neovim, for instance. As a result some plugins will clash with this one, whereas
+other plugins handle orthogonal concerns and can be used in addition to this one.
+Below is a categorized (incomplete) list of available plugins.
+
+## Render in Neovim
+
+Using any of these plugins with this one will likely lead to undesired behavior as
+different functionality will clash.
 
 - [headlines.nvim](https://github.com/lukas-reineke/headlines.nvim) - Same high
-  level idea different features
-- [markdown-preview.nvim](https://github.com/iamcco/markdown-preview.nvim) - Uses
-  browser
-- [vim-markdown-composer](https://github.com/euclio/vim-markdown-composer) - Uses
-  browser
+  level idea and starting point of this plugin, but with different feature sets
+
+## Render in Browser
+
+These can be used as a second pass to get a real preview of the `markdown` file.
+Since they do not interact with the buffer directly there should be no issues.
+
+- [markdown-preview.nvim](https://github.com/iamcco/markdown-preview.nvim)
+- [vim-markdown-composer](https://github.com/euclio/vim-markdown-composer)
+
+## Orthogonal
+
+These plugins handle functions completely separate from rendering and should also
+have no issues running alongside this plugin.
+
+- Any LSP which provides standard LSP capabilities, such as:
+  - [marksman](https://github.com/artempyanykh/marksman) - General completion,
+    definition, and reference functionality
+  - [markdown-oxide](https://github.com/Feel-ix-343/markdown-oxide) - Adds Obsidian
+    PKM features to LSP
+- [markdown.nvim](https://github.com/tadmccorkle/markdown.nvim) - Adds `markdown`
+  specific keybindings for interacting with `markdown` files

doc/render-markdown.txt

@@ -1,4 +1,4 @@
-*render-markdown.txt*           For 0.9.5           Last change: 2024 March 27
+*render-markdown.txt*           For 0.9.5           Last change: 2024 March 29
 
 ==============================================================================
 Table of Contents                          *render-markdown-table-of-contents*
@@ -11,7 +11,10 @@ Table of Contents                          *render-markdown-table-of-contents*
 5. Setup                                               |render-markdown-setup|
 6. Commands                                         |render-markdown-commands|
 7. Purpose                                           |render-markdown-purpose|
-8. Related Projects                         |render-markdown-related-projects|
+8. Markdown Ecosystem                     |render-markdown-markdown-ecosystem|
+  - Render in Neovim     |render-markdown-markdown-ecosystem-render-in-neovim|
+  - Render in Browser   |render-markdown-markdown-ecosystem-render-in-browser|
+  - Orthogonal                 |render-markdown-markdown-ecosystem-orthogonal|
 9. Links                                               |render-markdown-links|
 
 ==============================================================================
@@ -179,14 +182,47 @@ this plugin.
 
 
 ==============================================================================
-8. Related Projects                         *render-markdown-related-projects*
+8. Markdown Ecosystem                     *render-markdown-markdown-ecosystem*
+
+There are many `markdown` plugins that specialize in different aspects of
+interacting with `markdown` files. This plugin specializes in rendering the
+buffer inside of Neovim, for instance. As a result some plugins will clash with
+this one, whereas other plugins handle orthogonal concerns and can be used in
+addition to this one. Below is a categorized (incomplete) list of available
+plugins.
+
+
+RENDER IN NEOVIM         *render-markdown-markdown-ecosystem-render-in-neovim*
+
+Using any of these plugins with this one will likely lead to undesired behavior
+as different functionality will clash.
 
 - headlines.nvim <https://github.com/lukas-reineke/headlines.nvim> - Same high
-    level idea different features
-- markdown-preview.nvim <https://github.com/iamcco/markdown-preview.nvim> - Uses
-    browser
-- vim-markdown-composer <https://github.com/euclio/vim-markdown-composer> - Uses
-    browser
+    level idea and starting point of this plugin, but with different feature sets
+
+
+RENDER IN BROWSER       *render-markdown-markdown-ecosystem-render-in-browser*
+
+These can be used as a second pass to get a real preview of the `markdown`
+file. Since they do not interact with the buffer directly there should be no
+issues.
+
+- markdown-preview.nvim <https://github.com/iamcco/markdown-preview.nvim>
+- vim-markdown-composer <https://github.com/euclio/vim-markdown-composer>
+
+
+ORTHOGONAL                     *render-markdown-markdown-ecosystem-orthogonal*
+
+These plugins handle functions completely separate from rendering and should
+also have no issues running alongside this plugin.
+
+- Any LSP which provides standard LSP capabilities, such as:
+    - marksman <https://github.com/artempyanykh/marksman> - General completion,
+        definition, and reference functionality
+    - markdown-oxide <https://github.com/Feel-ix-343/markdown-oxide> - Adds Obsidian
+        PKM features to LSP
+- markdown.nvim <https://github.com/tadmccorkle/markdown.nvim> - Adds `markdown`
+    specific keybindings for interacting with `markdown` files
 
 ==============================================================================
 9. Links                                               *render-markdown-links*