---
gardenid: JOURN10
---
# [[2022-01-25]]
- [[Health]]
	- Had a really nast episode of [[depersonalization]] during the early morning. I'm still not 100% fully recovered from it, but I'm better.
		- Talking with my partner helped a lot. Sleeping too.
		- I think this is a sign that I should reinstate my [[meditation]] routine. It helped me a lot when these episodes were more frequent in [[2017]].
- [[Lightweight markup language]]
	- I'm trying to find an alternative for [[Markdown]] for writing the content of my site.
		- *What I need in a [[lightweight markup language]] for my site:*
			- As much compatibility with [[HTML]] as possible.
			- Syntax for adding anchor, semantic and arbitrary atributes to [[HTML element]]s.
			- Extensibility.
		- My options so far:
			- [[kramdown]]

					argdown
					[kramdown]: Should I use kramdown for the content of my site?
						+ kramdown is a Markdown flavor, and Markdown is *de facto* the lightweight markup language *franca* on the internet.
							+ I'm already used to Markdown, especially the GFM flavor.
							- Markdown flavors' differences aren't always incremental. Sometimes their syntax for the same elements differ.
							+ Regular textual elements are fairly easy to copy-and-paste from one Markdown flavor to another.
								+ This is even more important when working with copying-and-pasting from one app that uses Markdown to another.
						+ Readable.
						+ First-class citizen on GitHub and GitLab.
						+ First-class citizen in the Agora.
						- Extensibility is mostly parser-dependant.
							+ But being able to add attributes to HTML elements partially circumvents this. 
						+ More compatible with HTML than regular Markdown.
							- But could be better.
						+ Jekyll supports it.  
						+ Syntax for adding anchor, semantic and arbitrary elements to HTML elements.
							+ <li> elements can have attributes added to them.
							- No syntax for adding attributes to <ul> elements, which is essential for my atomic/transclusion dependant workflow.
			- [[AsciiDoc]] + [[AsciiDoctor]]

					argdown
					[AsciiDoc + AsciiDoctor]: Should I use AsciiDoc + AsciiDoctor for the content of my site?
					+ Extensible.
					+ Popular, widely used, with a rich ecossystem.
						-  Markdown still surpasses it on the use and popularity aspect.
					+ Readable. 
					+ First-class citizen on GitHub and GitLab.
					+ Great compatibility with HTML.
					- Not a first-class citizen in the Agora.
						- However, there are many ways to convert AsciiDoc to Markdown.
					- Jekyll does not support it.
						- A jekyll-asciidoc gem exists.
							- It hasn't been updated for months.
						- There are ways to import HTML (to which AsciiDoc can be exported) into Jekyll.
					+ Syntax for adding anchor, semantic and arbitrary elements to HTML elements.
						+ <li> elements can have id attributes added to them.
							- Support for semantic and arbitrary attributes is yet to be implemented.
								- There's an active discussion about implementing it however.
						+ <ul> elements can have attributes added to them.
			- [[org-mode]]

					argdown
					[org-mode]: Should I use AsciiDoc + AsciiDoctor for the content of my site?
					+ Extensible.
						+ org-babel makes org-mode *really* extensible.
					+ Popular and widely used desktop-wise, and part of the rich GNU Emacs ecossystem.
						- Non-existent as an Internet lightweight markup language (it was never its purpose).
						+ Direct integration between my private and public digital gardens.
						- I'm a Neovim user. I don't use GNU Emacs, neither I'm really interested in using it.
							- There are ways to use org-mode files in Neovim.
								- However, this makes the GNU Emacs ecossystem useless.
					+ Readable.
					+ First-class citizen on GitHub and GitLab.
					- Not a first-class citizen in the Agora.
						- However, there are many ways to conver org-mode to Markdown.
					- Jekyll does not support it.
						- jekyll-org and jekyll-org-to-html exist.
							- Both haven't been updated for years.
						- There are ways to import HTML (to which AsciiDoc can be exported) into Jekyll.
					+ Natively supported by Logseq.
					+ Great compatibility with HTML.
					- Slightly more convoluted syntax than the other options.
						- However, not in a crazy way
					+ Syntax for adding anchor, semantic and arbitrary elements to HTML elements.