aboutsummaryrefslogtreecommitdiff
path: root/_markdown.qmd
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2025-03-18 09:40:24 +0100
committerJonas Smedegaard <dr@jones.dk>2025-03-18 09:40:24 +0100
commit57dcb94ba9728def667799d3e81f59235259b33d (patch)
tree78b34f75b0c76c421de4967227aeb3dd91ccfbb7 /_markdown.qmd
parentfa348679c737a06dd9c74caaab78a035abc89d16 (diff)
rename file markdown -> formats, and expand content
Diffstat (limited to '_markdown.qmd')
-rw-r--r--_markdown.qmd48
1 files changed, 0 insertions, 48 deletions
diff --git a/_markdown.qmd b/_markdown.qmd
deleted file mode 100644
index 56d4c76..0000000
--- a/_markdown.qmd
+++ /dev/null
@@ -1,48 +0,0 @@
-Markdown is a text markup language
-with an emphasis on being easy for humans to read
-[@Gruber2004].
-
-Compared to word processors like Microsoft Word and LibreOffice Writer,
-Markdown authoring stores both content and markup together
-in a human-readable tekst file.
-
-::: {#fig-formality}
-
-```
-informal /---------formatted text----------\ formal
-<------v-------------v-------------v-----------------------v---->
- plain text informal markup formal markup binary format
- (Markdown) (HTML, XML, etc.)
-```
-
-Markdown is informal, ASCII-based markup
-[@Leonard2016, p. 4]
-
-:::
-
-HTML is itself a plaintext format,
-but is less human-readable.
-Similarly the format LaTeX is also plaintext,
-but its markdown arguably distracts the reading process
-[@Mailund2019chap2, p. 9].
-
-## Alternatives
-
-Other human-readable document source formats exists.
-
-FIXME reStructuredText.
-FIXME Org-mode.
-FIXME AsciiDoc.
-
-## Integration
-
-Markdown is in widespread use.
-
-Major source forges use Markdown by default for `README` files
-[@Github2025; @GitLab2025; @Codeberg2024].
-Some major programming languages
-natively support Markdown in embedded docstrings
-in core tools
-[@Microsoft2023; @Oracle2025; @RustTeam2024];
-others offer optional support e.g. through plugins
-[@Heesch2025; @Sphinx2025; @JSDoc2023].