Skip to content

Instantly share code, notes, and snippets.

@jskherman
Last active May 19, 2024 04:26
Show Gist options
  • Save jskherman/8e721302e67d308e8a81f3df84f01f20 to your computer and use it in GitHub Desktop.
Save jskherman/8e721302e67d308e8a81f3df84f01f20 to your computer and use it in GitHub Desktop.
A Pandoc Lua filter to convert Callout Blocks to Hugo admonitions (shortcode).
-- Pandoc Lua-filter for Obsidian Callouts
-- Original Source: https://forum.obsidian.md/t/rendering-callouts-similarly-in-pandoc/40020/
-- Notes:
-- Original snippet modified to output Hugo {{< admonition >}} shortcodes with collapse.
-- Make sure to have a blank line before and after the `> [!note]` line of the callout block.
-- The filter works recursively so if you want callouts within callouts, make sure to leave a blank line
-- before and after the `> [!note] Your title here` line of each callout.
-- Usage:
-- ```
-- pandoc -s input_obsidian.md --lua-filter admonition.lua -t markdown -o input_hugo.md
-- ```
-- Source: https://stackoverflow.com/a/33511182
-- Function to check if array contains a specific value
local function has_value(tab, val)
for index, value in ipairs(tab) do
if value == val then
return true
end
end
return false
end
-- --
-- For getting the plain string use `stringify`.
-- local stringify = (require "pandoc.utils").stringify
local callouts = { 'note', 'warning', 'tip', 'important', 'caution' }
function BlockQuote(el)
start = el.content[1]
if (start.t == "Para" and start.content[1].t == "Str" and start.content[1].text:match("^%[!%w+%][-+]?%s?.*$")) then
_, _, ctype = start.content[1].text:find("%[!(%w+)%]")
_, _, collapse = start.content[1].text:find("%[!%w+%]([-+]?)")
if (#start.content > 2 and start.content[2].t == "Space") then
titletext = ""
titletable = table.pack(table.unpack(start.content, 3))
for i, v in ipairs(titletable) do
if v.t == "Space" then
titletext = titletext .. " "
else
titletext = titletext .. v.text
end
end
else
titletext = ctype:upper()
end
el.content:remove(1)
start.content:remove(1)
if has_value(callouts, ctype:lower()) then
div = pandoc.RawBlock("markdown", '{{< admonition type="' ..
ctype:lower() .. '" title="' .. titletext ..
'" open=' .. tostring(collapse ~= "-") .. ' >}}' ..
"\n\n" .. pandoc.write(pandoc.Pandoc(el.content), "markdown") ..
'{{< /admonition >}}', "")
else
div = pandoc.RawBlock("{{< admonition type='note' open=true >}}" ..
pandoc.write(pandoc.Pandoc(el.content), "markdown") .. "{{< /admonition>}}", "")
end
return div
else
return el
end
end
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment