0xdevalias · January 13, 2025 23:32
diff --git a/1_poc-pandoc-markdown-lua-filter.md b/1_poc-pandoc-markdown-lua-filter.md
diff --git a/2_pandoc-markdown-devalias.lua b/2_pandoc-markdown-devalias.lua
 -- Filter to customize markdown output
 --
 -- Configurable via metadata options:
 --   bullet-marker: character to use for bullet lists ('-' or '*')
 --   emphasis-marker: character to use for emphasis ('_' or '*')
 --
 -- Configuration can be provided via:
 --   YAML metadata in the document
 --   Command line: --metadata bullet-marker='-' --metadata emphasis-marker='_'
 --   Metadata file: --metadata-file config.yaml
 --
 -- Example:
 --   pbpaste | pandoc -f html -t gfm --lua-filter pandoc-markdown-devalias.lua --metadata bullet-marker='-' --metadata emphasis-marker='_'
 --
 -- Ref:
 --   https://gist.github.com/0xdevalias/794d1aa03c357425c4c9583d9edc0303#poc-pandoc---lua-filter-for-customizing-markdown-output
 --   https://pandoc.org/lua-filters.html
 --   https://pandoc.org/lua-filters.html#type-writeroptions

 -- Default values if not specified in metadata
 local debug_mode = false
 local bullet_marker = '-'
 local bullet_marker_indent = string.rep(" ", #bullet_marker)
 local emphasis_marker = '_'

 -- Helper function for debug logging
 -- TODO: Potentially improve with pandoc.log: (https://pandoc.org/lua-filters.html#module-pandoc.log) or https://github.com/pandoc-ext/logging
 local function debug(msg, ...)
    if debug_mode then
        io.stderr:write(string.format("[DEBUG] " .. msg .. "\n", ...))
    end
 end

 -- Helper function to safely extract values from Pandoc's metadata
 -- Handles boolean values directly and converts other types appropriately
 --
 -- @param meta: The metadata table from Pandoc
 -- @param key: The key to look up in the metadata
 -- @param default: Value to return if key is not found
 -- @return: Value from metadata (preserving boolean type) or default
 function get_metadata_value(meta, key, default)
    local value = meta[key]
    if value == nil then
        return default
    end

    if type(value) == "boolean" then
        return value
    end

    if type(value) == "table" and value.text ~= nil then
        return value.text
    end

    return tostring(value)
 end

 -- Processes document metadata to configure the filter
 -- Called by Pandoc at the start of document processing
 --
 -- @param meta: The document's metadata table
 -- @return: The (possibly modified) metadata table
 function Meta(meta)
    -- Read configuration from metadata, falling back to defaults if not specified
    debug_mode = get_metadata_value(meta, 'debug', debug_mode) == true
    bullet_marker = get_metadata_value(meta, 'bullet-marker', bullet_marker)
    bullet_marker_indent = string.rep(" ", #bullet_marker)
    emphasis_marker = get_metadata_value(meta, 'emphasis-marker', emphasis_marker)

    debug("Initialized with FORMAT: %s", FORMAT)
    debug("bullet-marker: %s", bullet_marker)
    debug("bullet-marker-indent: '%s' (without quotes)", bullet_marker_indent)
    debug("emphasis-marker: %s", emphasis_marker)
    debug("debug-mode: %s", debug_mode)

    return meta
 end

 -- Processes emphasis elements (italic text) by converting them to raw format
 -- Ensures consistent emphasis marker usage throughout the document
 --
 -- @param el: The emphasis element (pandoc AST element)
 -- @return: A RawInline element with explicitly formatted emphasis markers
 --
 -- Note: Uses the global FORMAT and emphasis_marker variables
 function Emph(el)
  -- Convert the inline content to a plain string
  local text = pandoc.utils.stringify(el)

  -- Build the new string, wrapping content with the custom marker
  local wrapped = emphasis_marker .. text .. emphasis_marker

  -- Return as raw Markdown (or another format if you prefer)
  return pandoc.RawInline("markdown", wrapped)
 end

 -- TODO: This feels overly complex still.. surely we can refactor it to be better/simpler somehow..?
 --   https://pandoc.org/lua-filters.html#pandoc.walk_block
 --   https://pandoc.org/lua-filters.html#pandoc.walk_inline
 --   https://pandoc.org/lua-filters.html#pandoc.write
 --     https://pandoc.org/lua-filters.html#type-writeroptions
 function BulletList(bulletList)
  -- https://pandoc.org/lua-filters.html#type-blocks:walk
  -- https://pandoc.org/lua-filters.html#traversal-order
  -- https://pandoc.org/lua-filters.html#pandoc.utils.blocks_to_inlines

  debug("Start of BulletList")

  -- local bullet = pandoc.List:new{
  --   pandoc.Str(bullet_marker),
  --   pandoc.Space()
  -- }

  -- local nestedIndent = pandoc.List:new{
  --   pandoc.Space(),
  --   pandoc.Space()
  -- }

  -- return bulletList:walk {
  --   Block = function (block)
  --     debug("block: %s %s", block.t, block)

  --     if block.t == "BulletList" then
  --       return block
  --     elseif block.content then
  --       block.content = pandoc.List:new{ pandoc.Str(bullet_marker), pandoc.Space() } .. block.content

  --       return block
  --     else
  --       return block
  --     -- else
  --     --   block.content = pandoc.List:new{ pandoc.Str(bullet_marker), pandoc.Space() } .. block.content

  --     --   return block
  --     end
  --   end,
  -- }

  local transformedBlocks = pandoc.List()

  -- Check the last item and append content if it's Plain or Para
  -- TODO: This may be useful here: https://pandoc.org/lua-filters.html#pandoc.utils.blocks_to_inlines
  local function updateLastBlock(block)
    local lastItem = transformedBlocks[#transformedBlocks]
    if lastItem and (lastItem.t == "Plain" or lastItem.t == "Para") then
      lastItem.content = lastItem.content .. {pandoc.LineBreak()} .. block.content
    else
      -- Either the last item is not Plain/Para, or the list is empty
      transformedBlocks:insert(block)
    end
  end

  -- local transformedBlocks = bulletList.content:map(function(item, i)
  for i, item in ipairs(bulletList.content) do
    -- TODO: pandoc.type might be better to use here: https://pandoc.org/lua-filters.html#pandoc.utils.type
    debug("  Item %d: %s %s", i, type(item), item)

    for j, block in ipairs(item) do
    -- return item:map(function(block, j)
      -- TODO: pandoc.type might be better to use here: https://pandoc.org/lua-filters.html#pandoc.utils.type
      debug("    Item %d, Block %d of %d: %s %s: %s", i, j, #item, type(block), block.t, block)

      if (block.t == "Plain" or block.t == "Para") then
        debug("      Handling '%s' block: %s, [1]: %s %s", block.t, block.content, block.content[1].t, block.content[1])

        -- TODO: instead of just processing the first item, I think we need to loop through all of them..
        local firstInline = block.content[1]
        -- TODO: Should this if run if firstInline.t is Str or Para, or just Str? Maybe needs to also handle RawInline now since we refactored..
        if (firstInline.t == "RawInline" or firstInline.t == "Str" or firstInline.t == "Para") and firstInline.text == bullet_marker then
          -- TODO: This works for indenting the first item, but when we have a nested BlockQuote or similar, it's following lines don't get indented properly
          block.content = pandoc.List{
            pandoc.Str("  "),
          } .. block.content
        else
          block.content = pandoc.List{
            -- pandoc.Str(bullet_marker .. " "),
            pandoc.RawInline("markdown", bullet_marker),
            pandoc.Space(),
          } .. block.content
        end

        updateLastBlock(block)
      elseif (block.t == "BlockQuote") then
        -- TODO: instead of just processing the first item, I think we need to loop through all of them..
        local firstInline = block.content[1]

        if not firstInline or (firstInline.t ~= "Para" and firstInline.t ~= "Plain") then
          return block
        end

        local inlines = pandoc.List{
          pandoc.RawInline("markdown", bullet_marker),
          pandoc.Space(),
          -- TODO: Is this useful for prefixing the blockquote lines? https://pandoc.org/lua-filters.html#pandoc.layout.prefixed
          pandoc.RawInline("markdown", ">"),
          pandoc.Space(),
        }

        for _, inline in ipairs(firstInline.content) do
          if inline.t == "LineBreak" then
            inlines = inlines .. {
              inline, -- LineBreak
              -- pandoc.Str(string.rep(" ", #bullet_marker)), -- TODO: move this to a global variable (bullet_marker_indent) if it works well?
              -- TODO: Is this useful for indents? https://pandoc.org/lua-filters.html#pandoc.layout.after_break
              -- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
              pandoc.Str(bullet_marker_indent),
              pandoc.Space(),
              -- TODO: Is this useful for prefixing the blockquote lines? https://pandoc.org/lua-filters.html#pandoc.layout.prefixed
              pandoc.RawInline("markdown", ">"),
              pandoc.Space(),
            }
          else
            inlines:insert(inline)
          end
        end

        -- transformedBlocks:insert(pandoc.Para(inlines))
        updateLastBlock(pandoc.Para(inlines))
      elseif (block.t == "CodeBlock") then
        local inlines = pandoc.List{
          pandoc.RawInline("markdown", bullet_marker),
          pandoc.Space(),
          -- TODO: is this useful for wrapping the codeblock contents/etc? https://pandoc.org/lua-filters.html#pandoc.layout.inside
          pandoc.RawInline("markdown", "```"),
          -- block.identifier
          -- ..
          pandoc.LineBreak(),
          -- pandoc.Str(string.rep(" ", #bullet_marker)),
          -- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
          pandoc.Str(bullet_marker_indent),
          pandoc.Space(),
          -- pandoc.RawInline("markdown", block.text:gsub("\n", "\n" .. string.rep(" ", #bullet_marker + 1))),
          -- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
          pandoc.RawInline("markdown", block.text:gsub("\n", "\n" .. bullet_marker_indent .. ' ')),
          pandoc.LineBreak(),
          -- pandoc.Str(string.rep(" ", #bullet_marker)),
          -- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
          pandoc.Str(bullet_marker_indent),
          pandoc.Space(),
          pandoc.RawInline("markdown", "```"),
        }

        updateLastBlock(pandoc.Para(inlines))

      -- elseif (block.t == "BulletList") then
      --   -- TODO: I'm not sure if we will ever actually get this since we transform bulletlist content, and I think we walk the AST depth first
      --   debug("HIT A BULLETLIST")

      --   -- return indent .. block
      --   -- return pandoc.List:new{

      --   -- transformedBlocks = transformedBlocks .. pandoc.List{
      --   --   pandoc.Space(),
      --   --   pandoc.Space(),
      --   --   block,
      --   -- }

      --   -- TODO: Do we need to do anything here? Or just leave it alone as it will be processed by another pass through this function?
      --   transformedBlocks:insert(block)
      else
        debug("      Handling else ('%s') block: %s, [1]: %s", block.t, block.content, block.content and block.content[1])
        -- TODO?

        -- return bullet .. block
        -- return pandoc.List:new{

        -- transformedBlocks = transformedBlocks .. pandoc.List{
        --   pandoc.Str(bullet_marker),
        --   pandoc.Space(),
        --   block,
        -- }

        -- transformedBlocks:insert(pandoc.Str(bullet_marker))
        -- transformedBlocks:insert(pandoc.Space())

        -- TODO: This still isn't quite right as it doesn't return the item prefixed with the list marker on the same line..
        transformedBlocks:insert(pandoc.List{
          pandoc.RawInline("markdown", bullet_marker),
          pandoc.Space(),
          -- block,
        })
        transformedBlocks:insert(block)

        -- updateLastBlock(pandoc.Para(inlines))

        -- transformedBlocks:insert(pandoc.Plain{
        --   pandoc.Str(bullet_marker),
        --   block,
        -- })

        -- transformedBlocks:insert(pandoc.Inlines{
        --   pandoc.Str(bullet_marker),
        --   pandoc.Space(),
        --   block,
        -- })
      end

      -- return block
  --   end)
  -- end)
    end
  end

  -- TODO: pandoc.type might be better to use here: https://pandoc.org/lua-filters.html#pandoc.utils.type
  debug("  type(transformedBlocks): %s", type(transformedBlocks))
  debug("  transformedBlocks: %s", transformedBlocks)
  for k, block in ipairs(transformedBlocks) do
    debug("    transformedBlocks Block %d of %d: %s %s: %s", k, #transformedBlocks, type(block), block.t, block)
  end

  -- local flattenedBlocks = pandoc.List(transformedBlocks):flatten()
  -- debug("  type(flattenedBlocks): %s", type(flattenedBlocks))
  -- debug("  flattenedBlocks: %s", flattenedBlocks)

  debug("End of BulletList")


  -- return bulletList

  -- return pandoc.Blocks{
  --   pandoc.Inlines{
  --       pandoc.Str(bullet_marker),
  --       pandoc.Space(),
  --   }
  -- }

  return transformedBlocks

  -- return pandoc.List(transformedBlocks):flatten()
 end

 return {
    {Meta = Meta},
    {BulletList = BulletList},
    {Emph = Emph},
 }
diff --git a/3_pandoc-markdown-devalias-emph-only.lua b/3_pandoc-markdown-devalias-emph-only.lua
 -- Filter to customize markdown output
 --
 -- Configurable via metadata options:
 --   bullet-marker: character to use for bullet lists ('-' or '*')
 --   emphasis-marker: character to use for emphasis ('_' or '*')
 --
 -- Configuration can be provided via:
 --   YAML metadata in the document
 --   Command line: --metadata bullet-marker='-' --metadata emphasis-marker='_'
 --   Metadata file: --metadata-file config.yaml
 --
 -- Example:
 --   pbpaste | pandoc -f html -t gfm --lua-filter pandoc-markdown-devalias-emph-only.lua --metadata emphasis-marker='_'
 --
 -- Ref:
 --   https://gist.github.com/0xdevalias/794d1aa03c357425c4c9583d9edc0303#poc-pandoc---lua-filter-for-customizing-markdown-output
 --   https://pandoc.org/lua-filters.html
 --   https://pandoc.org/lua-filters.html#type-writeroptions

 -- Default values if not specified in metadata
 local debug_mode = false
 local emphasis_marker = '_'

 -- Helper function for debug logging
 local function debug(msg, ...)
    if debug_mode then
        io.stderr:write(string.format("[DEBUG] " .. msg .. "\n", ...))
    end
 end

 -- Helper function to safely extract values from Pandoc's metadata
 -- Handles boolean values directly and converts other types appropriately
 --
 -- @param meta: The metadata table from Pandoc
 -- @param key: The key to look up in the metadata
 -- @param default: Value to return if key is not found
 -- @return: Value from metadata (preserving boolean type) or default
 function get_metadata_value(meta, key, default)
    local value = meta[key]
    if value == nil then
        return default
    end

    if type(value) == "boolean" then
        return value
    end

    if type(value) == "table" and value.text ~= nil then
        return value.text
    end

    return tostring(value)
 end

 -- Processes document metadata to configure the filter
 -- Called by Pandoc at the start of document processing
 --
 -- @param meta: The document's metadata table
 -- @return: The (possibly modified) metadata table
 function Meta(meta)
    -- Read configuration from metadata, falling back to defaults if not specified
    debug_mode = get_metadata_value(meta, 'debug', debug_mode) == true
    emphasis_marker = get_metadata_value(meta, 'emphasis-marker', emphasis_marker)

    debug("Initialized with FORMAT: %s", FORMAT)
    debug("emphasis-marker: %s", emphasis_marker)
    debug("debug-mode: %s", debug_mode)

    return meta
 end

 -- Processes emphasis elements (italic text) by converting them to raw format
 --
 -- @param el: The emphasis element (pandoc AST element)
 -- @return: A RawInline element with explicitly formatted emphasis markers
 function Emph(el)
  -- Convert the inline content to a plain string
  local text = pandoc.utils.stringify(el)

  -- Build the new string, wrapping content with the custom marker
  local wrapped = emphasis_marker .. text .. emphasis_marker

  -- Return as raw Markdown (or another format if you prefer)
  return pandoc.RawInline("markdown", wrapped)
 end

 return {
    {Meta = Meta},
    {Emph = Emph},
 }
diff --git a/4_pandoc-markdown-devalias-emph-static.lua b/4_pandoc-markdown-devalias-emph-static.lua
 -- Filter to customize markdown output
 --
 -- Example:
 --   pbpaste | pandoc -f html -t gfm --lua-filter pandoc-markdown-devalias-emph-static.lua
 --
 -- Ref:
 --   https://gist.github.com/0xdevalias/794d1aa03c357425c4c9583d9edc0303#poc-pandoc---lua-filter-for-customizing-markdown-output
 --   https://pandoc.org/lua-filters.html
 --   https://pandoc.org/lua-filters.html#type-writeroptions

 -- Processes emphasis elements (italic text) by converting them to raw format
 --
 -- @param el: The emphasis element (pandoc AST element)
 -- @return: A RawInline element with explicitly formatted emphasis markers
 function Emph(el)
  -- Convert the inline content to a plain string
  local text = pandoc.utils.stringify(el)

  -- Build the new string, wrapping content with the custom marker
  local wrapped = emphasis_marker .. text .. emphasis_marker

  -- Return as raw Markdown (or another format if you prefer)
  return pandoc.RawInline("markdown", wrapped)
 end

 return {
    {Emph = Emph},
 }
	-- Filter to customize markdown output
	--
	-- Configurable via metadata options:
	-- bullet-marker: character to use for bullet lists ('-' or '*')
	-- emphasis-marker: character to use for emphasis ('_' or '*')
	--
	-- Configuration can be provided via:
	-- YAML metadata in the document
	-- Command line: --metadata bullet-marker='-' --metadata emphasis-marker='_'
	-- Metadata file: --metadata-file config.yaml
	--
	-- Example:
	-- pbpaste \| pandoc -f html -t gfm --lua-filter pandoc-markdown-devalias.lua --metadata bullet-marker='-' --metadata emphasis-marker='_'
	--
	-- Ref:
	-- https://gist.github.com/0xdevalias/794d1aa03c357425c4c9583d9edc0303#poc-pandoc---lua-filter-for-customizing-markdown-output
	-- https://pandoc.org/lua-filters.html
	-- https://pandoc.org/lua-filters.html#type-writeroptions

	-- Default values if not specified in metadata
	local debug_mode = false
	local bullet_marker = '-'
	local bullet_marker_indent = string.rep(" ", #bullet_marker)
	local emphasis_marker = '_'

	-- Helper function for debug logging
	-- TODO: Potentially improve with pandoc.log: (https://pandoc.org/lua-filters.html#module-pandoc.log) or https://github.com/pandoc-ext/logging
	local function debug(msg, ...)
	if debug_mode then
	io.stderr:write(string.format("[DEBUG] " .. msg .. "\n", ...))
	end
	end

	-- Helper function to safely extract values from Pandoc's metadata
	-- Handles boolean values directly and converts other types appropriately
	--
	-- @param meta: The metadata table from Pandoc
	-- @param key: The key to look up in the metadata
	-- @param default: Value to return if key is not found
	-- @return: Value from metadata (preserving boolean type) or default
	function get_metadata_value(meta, key, default)
	local value = meta[key]
	if value == nil then
	return default
	end

	if type(value) == "boolean" then
	return value
	end

	if type(value) == "table" and value.text ~= nil then
	return value.text
	end

	return tostring(value)
	end

	-- Processes document metadata to configure the filter
	-- Called by Pandoc at the start of document processing
	--
	-- @param meta: The document's metadata table
	-- @return: The (possibly modified) metadata table
	function Meta(meta)
	-- Read configuration from metadata, falling back to defaults if not specified
	debug_mode = get_metadata_value(meta, 'debug', debug_mode) == true
	bullet_marker = get_metadata_value(meta, 'bullet-marker', bullet_marker)
	bullet_marker_indent = string.rep(" ", #bullet_marker)
	emphasis_marker = get_metadata_value(meta, 'emphasis-marker', emphasis_marker)

	debug("Initialized with FORMAT: %s", FORMAT)
	debug("bullet-marker: %s", bullet_marker)
	debug("bullet-marker-indent: '%s' (without quotes)", bullet_marker_indent)
	debug("emphasis-marker: %s", emphasis_marker)
	debug("debug-mode: %s", debug_mode)

	return meta
	end

	-- Processes emphasis elements (italic text) by converting them to raw format
	-- Ensures consistent emphasis marker usage throughout the document
	--
	-- @param el: The emphasis element (pandoc AST element)
	-- @return: A RawInline element with explicitly formatted emphasis markers
	--
	-- Note: Uses the global FORMAT and emphasis_marker variables
	function Emph(el)
	-- Convert the inline content to a plain string
	local text = pandoc.utils.stringify(el)

	-- Build the new string, wrapping content with the custom marker
	local wrapped = emphasis_marker .. text .. emphasis_marker

	-- Return as raw Markdown (or another format if you prefer)
	return pandoc.RawInline("markdown", wrapped)
	end

	-- TODO: This feels overly complex still.. surely we can refactor it to be better/simpler somehow..?
	-- https://pandoc.org/lua-filters.html#pandoc.walk_block
	-- https://pandoc.org/lua-filters.html#pandoc.walk_inline
	-- https://pandoc.org/lua-filters.html#pandoc.write
	-- https://pandoc.org/lua-filters.html#type-writeroptions
	function BulletList(bulletList)
	-- https://pandoc.org/lua-filters.html#type-blocks:walk
	-- https://pandoc.org/lua-filters.html#traversal-order
	-- https://pandoc.org/lua-filters.html#pandoc.utils.blocks_to_inlines

	debug("Start of BulletList")

	-- local bullet = pandoc.List:new{
	-- pandoc.Str(bullet_marker),
	-- pandoc.Space()
	-- }

	-- local nestedIndent = pandoc.List:new{
	-- pandoc.Space(),
	-- pandoc.Space()
	-- }

	-- return bulletList:walk {
	-- Block = function (block)
	-- debug("block: %s %s", block.t, block)

	-- if block.t == "BulletList" then
	-- return block
	-- elseif block.content then
	-- block.content = pandoc.List:new{ pandoc.Str(bullet_marker), pandoc.Space() } .. block.content

	-- return block
	-- else
	-- return block
	-- -- else
	-- -- block.content = pandoc.List:new{ pandoc.Str(bullet_marker), pandoc.Space() } .. block.content

	-- -- return block
	-- end
	-- end,
	-- }

	local transformedBlocks = pandoc.List()

	-- Check the last item and append content if it's Plain or Para
	-- TODO: This may be useful here: https://pandoc.org/lua-filters.html#pandoc.utils.blocks_to_inlines
	local function updateLastBlock(block)
	local lastItem = transformedBlocks[#transformedBlocks]
	if lastItem and (lastItem.t == "Plain" or lastItem.t == "Para") then
	lastItem.content = lastItem.content .. {pandoc.LineBreak()} .. block.content
	else
	-- Either the last item is not Plain/Para, or the list is empty
	transformedBlocks:insert(block)
	end
	end

	-- local transformedBlocks = bulletList.content:map(function(item, i)
	for i, item in ipairs(bulletList.content) do
	-- TODO: pandoc.type might be better to use here: https://pandoc.org/lua-filters.html#pandoc.utils.type
	debug(" Item %d: %s %s", i, type(item), item)

	for j, block in ipairs(item) do
	-- return item:map(function(block, j)
	-- TODO: pandoc.type might be better to use here: https://pandoc.org/lua-filters.html#pandoc.utils.type
	debug(" Item %d, Block %d of %d: %s %s: %s", i, j, #item, type(block), block.t, block)

	if (block.t == "Plain" or block.t == "Para") then
	debug(" Handling '%s' block: %s, [1]: %s %s", block.t, block.content, block.content[1].t, block.content[1])

	-- TODO: instead of just processing the first item, I think we need to loop through all of them..
	local firstInline = block.content[1]
	-- TODO: Should this if run if firstInline.t is Str or Para, or just Str? Maybe needs to also handle RawInline now since we refactored..
	if (firstInline.t == "RawInline" or firstInline.t == "Str" or firstInline.t == "Para") and firstInline.text == bullet_marker then
	-- TODO: This works for indenting the first item, but when we have a nested BlockQuote or similar, it's following lines don't get indented properly
	block.content = pandoc.List{
	pandoc.Str(" "),
	} .. block.content
	else
	block.content = pandoc.List{
	-- pandoc.Str(bullet_marker .. " "),
	pandoc.RawInline("markdown", bullet_marker),
	pandoc.Space(),
	} .. block.content
	end

	updateLastBlock(block)
	elseif (block.t == "BlockQuote") then
	-- TODO: instead of just processing the first item, I think we need to loop through all of them..
	local firstInline = block.content[1]

	if not firstInline or (firstInline.t ~= "Para" and firstInline.t ~= "Plain") then
	return block
	end

	local inlines = pandoc.List{
	pandoc.RawInline("markdown", bullet_marker),
	pandoc.Space(),
	-- TODO: Is this useful for prefixing the blockquote lines? https://pandoc.org/lua-filters.html#pandoc.layout.prefixed
	pandoc.RawInline("markdown", ">"),
	pandoc.Space(),
	}

	for _, inline in ipairs(firstInline.content) do
	if inline.t == "LineBreak" then
	inlines = inlines .. {
	inline, -- LineBreak
	-- pandoc.Str(string.rep(" ", #bullet_marker)), -- TODO: move this to a global variable (bullet_marker_indent) if it works well?
	-- TODO: Is this useful for indents? https://pandoc.org/lua-filters.html#pandoc.layout.after_break
	-- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
	pandoc.Str(bullet_marker_indent),
	pandoc.Space(),
	-- TODO: Is this useful for prefixing the blockquote lines? https://pandoc.org/lua-filters.html#pandoc.layout.prefixed
	pandoc.RawInline("markdown", ">"),
	pandoc.Space(),
	}
	else
	inlines:insert(inline)
	end
	end

	-- transformedBlocks:insert(pandoc.Para(inlines))
	updateLastBlock(pandoc.Para(inlines))
	elseif (block.t == "CodeBlock") then
	local inlines = pandoc.List{
	pandoc.RawInline("markdown", bullet_marker),
	pandoc.Space(),
	-- TODO: is this useful for wrapping the codeblock contents/etc? https://pandoc.org/lua-filters.html#pandoc.layout.inside
	pandoc.RawInline("markdown", "```"),
	-- block.identifier
	-- ..
	pandoc.LineBreak(),
	-- pandoc.Str(string.rep(" ", #bullet_marker)),
	-- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
	pandoc.Str(bullet_marker_indent),
	pandoc.Space(),
	-- pandoc.RawInline("markdown", block.text:gsub("\n", "\n" .. string.rep(" ", #bullet_marker + 1))),
	-- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
	pandoc.RawInline("markdown", block.text:gsub("\n", "\n" .. bullet_marker_indent .. ' ')),
	pandoc.LineBreak(),
	-- pandoc.Str(string.rep(" ", #bullet_marker)),
	-- TODO: Is this useful for indentation? https://pandoc.org/lua-filters.html#pandoc.layout.nest
	pandoc.Str(bullet_marker_indent),
	pandoc.Space(),
	pandoc.RawInline("markdown", "```"),
	}

	updateLastBlock(pandoc.Para(inlines))

	-- elseif (block.t == "BulletList") then
	-- -- TODO: I'm not sure if we will ever actually get this since we transform bulletlist content, and I think we walk the AST depth first
	-- debug("HIT A BULLETLIST")

	-- -- return indent .. block
	-- -- return pandoc.List:new{

	-- -- transformedBlocks = transformedBlocks .. pandoc.List{
	-- -- pandoc.Space(),
	-- -- pandoc.Space(),
	-- -- block,
	-- -- }

	-- -- TODO: Do we need to do anything here? Or just leave it alone as it will be processed by another pass through this function?
	-- transformedBlocks:insert(block)
	else
	debug(" Handling else ('%s') block: %s, [1]: %s", block.t, block.content, block.content and block.content[1])
	-- TODO?

	-- return bullet .. block
	-- return pandoc.List:new{

	-- transformedBlocks = transformedBlocks .. pandoc.List{
	-- pandoc.Str(bullet_marker),
	-- pandoc.Space(),
	-- block,
	-- }

	-- transformedBlocks:insert(pandoc.Str(bullet_marker))
	-- transformedBlocks:insert(pandoc.Space())

	-- TODO: This still isn't quite right as it doesn't return the item prefixed with the list marker on the same line..
	transformedBlocks:insert(pandoc.List{
	pandoc.RawInline("markdown", bullet_marker),
	pandoc.Space(),
	-- block,
	})
	transformedBlocks:insert(block)

	-- updateLastBlock(pandoc.Para(inlines))

	-- transformedBlocks:insert(pandoc.Plain{
	-- pandoc.Str(bullet_marker),
	-- block,
	-- })

	-- transformedBlocks:insert(pandoc.Inlines{
	-- pandoc.Str(bullet_marker),
	-- pandoc.Space(),
	-- block,
	-- })
	end

	-- return block
	-- end)
	-- end)
	end
	end

	-- TODO: pandoc.type might be better to use here: https://pandoc.org/lua-filters.html#pandoc.utils.type
	debug(" type(transformedBlocks): %s", type(transformedBlocks))
	debug(" transformedBlocks: %s", transformedBlocks)
	for k, block in ipairs(transformedBlocks) do
	debug(" transformedBlocks Block %d of %d: %s %s: %s", k, #transformedBlocks, type(block), block.t, block)
	end

	-- local flattenedBlocks = pandoc.List(transformedBlocks):flatten()
	-- debug(" type(flattenedBlocks): %s", type(flattenedBlocks))
	-- debug(" flattenedBlocks: %s", flattenedBlocks)

	debug("End of BulletList")


	-- return bulletList

	-- return pandoc.Blocks{
	-- pandoc.Inlines{
	-- pandoc.Str(bullet_marker),
	-- pandoc.Space(),
	-- }
	-- }

	return transformedBlocks

	-- return pandoc.List(transformedBlocks):flatten()
	end

	return {
	{Meta = Meta},
	{BulletList = BulletList},
	{Emph = Emph},
	}