Markdown - Revision history

Ted: Add notes regarding need for ignore directive with mdformat utility

2026-02-10T17:27:54Z

Add notes regarding need for ignore directive with mdformat utility

Ted: Add notes on mdformat installation

2026-02-10T16:59:55Z

Add notes on mdformat installation

Ted: Add link to mdformat tool documentation

2025-12-17T18:52:53Z

Add link to mdformat tool documentation

Ted: Create local page for notes on Markdown

2025-12-17T18:52:11Z

Create local page for notes on Markdown

New page

Markdown auto-formatting tools mdformat:

* https://pypi.org/project/mdformat/0.5.1/

* https://mdformat.readthedocs.io/en/stable/users/installation_and_usage.html

← Older revision		Revision as of 17:27, 10 February 2026
Line 23:		Line 23:
	</pre>		</pre>

		+	== Markdown Project Issues ==
		+
		+	Need for ignore directive with mdformat utility:
		+
		+	Markdown as formatting tool does not as of 2026 Q1 support "ignore block" directives. It formats the entire document. For single spaced bullet lists it concatenates each line and bullet point into a single line. Not helpful! A Github issue has been raised regarding this:
		+
		+	* https://github.com/hukkin/mdformat/issues/53

	<!-- EOF -->		<!-- EOF -->

← Older revision		Revision as of 16:59, 10 February 2026
Line 9:		Line 9:

	* https://mdformat.readthedocs.io/en/stable/users/style.html		* https://mdformat.readthedocs.io/en/stable/users/style.html
		+
		+	2026-02-10 - Possible common localhost set up
		+
		+	A localhost can have multiple Python virtual environments. If a common way of using mdformat is desired it may make sense to create a `venv` in the localhost user's home directory, and to then install mdformat as follows:
		+
		+	<pre>
		+	1022 python3 -m venv .venv
		+	1023 source ./.venv/bin/activate
		+	1025 pip install pipx
		+	1026 pipx install mdformat
		+	1027 pipx inject mdformat mdformat-gfm
		+	1028 history
		+	</pre>
		+
		+
		+	<!-- EOF -->

← Older revision		Revision as of 18:52, 17 December 2025
Line 5:		Line 5:

	* https://mdformat.readthedocs.io/en/stable/users/installation_and_usage.html		* https://mdformat.readthedocs.io/en/stable/users/installation_and_usage.html
		+
		+	link to mdformat tool documentation:
		+
		+	* https://mdformat.readthedocs.io/en/stable/users/style.html