From b79e0c875103a20eb463fc94ca082d0db1e3800f Mon Sep 17 00:00:00 2001 From: Stijn van Houwelingen Date: Tue, 23 Jan 2024 22:27:12 +0100 Subject: [PATCH] Small addition to the text --- content/blog/markup-iceberg.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/blog/markup-iceberg.md b/content/blog/markup-iceberg.md index d531abb..c02e738 100644 --- a/content/blog/markup-iceberg.md +++ b/content/blog/markup-iceberg.md @@ -153,7 +153,7 @@ header-includes: | hello there \newpage ``` -As you can see, the seperation between settings and content is very clear in the Pandoc Markdown and the syntax is a lot more concise and easy to read. Pandoc Markdown also allows you to use snippets of LaTeX. This is very usefull for the 5% of the time when you need to do something which you can't do in Markdown, like start a new page. The result is still 95% readable Markdown with some LaTeX commands here and there. +As you can see, the seperation between settings and content is very clear in the Pandoc Markdown and the syntax is a lot more concise and easy to read. Pandoc Markdown also allows you to use snippets of LaTeX. This is very usefull for the 5% of the time when you need to do something which you can't do in Markdown, like start a new page. The result is still 95% readable Markdown with some LaTeX commands here and there. When using this setup, the pipeline is like this: @@ -162,6 +162,8 @@ Pandoc Markdown -> LaTeX -> _anything_ This is usefull to remember when you are debugging your frontformatter: if LaTeX has an error, first look in your Frontformatter/Pandoc. This anything can be a PDF document for example. +This pattern of most of the content being Markdown and a small percent being some kind of "escape hatch system" is very common when using Markdown. For some systems, the escape hatch is HTML (which is support most of the time as Markdown is a superset of HTML), most static site generators have "shortcodes" and as we have just seen, Pandoc Markdown has LaTeX. + # Essays with Markdown Writing essays with Pandoc uses the afforementioned techniques, but there are some specific things I want add.