jekyll process converts markdown first before applying layout

• Jekyll’s rendering phase is further divisible into three optional stages with the output from a stage being the input for the succeeding stage:

  • Every file rendered, passes through one or more of these stages as determined by the file’s content string, front matter and extension.
  • The three optional stages
    • Interpreting Liquid expressions in the file
      • evaluates Liquid expressions in the current file
      • any Liquid expression in the file’s front matter is left untouched.
    • Unleashing the converters
      • invokes the converter mapped to the current file’s extension and converts the input string. This is when Markdown gets converted into HTML and Sass / Scss into CSS
      • Since this is determined by the file’s extension, Markdown inside a .html file will remain untouched.
    • Populating the layouts
      • By this stage, the source file is considered rendered and it will not be revisited.
      • However, based on the file’s extension and consequently based on the front matter, it is determined whether to take the output string from the preceding stage and place into layouts or not.

• Jekyll processes/converts markdown page to html before applying the Layouts – so any liquid scripts in the layout need to address content as an HTML

  • liquid scripts such as to convert blockquote to callout then must search for <blockquote> instead of > (see jekyll liquid for converting obsidian calloutjekyll liquid for converting obsidian callout
    
    
    this liquid snippet will find blockquote in jekyll website and detect whether it’s an obsidian callout – if so, tag with the appropriate class
    
    still missing, I should add class="...)
  • this will be trickier to do for markdown aliases i.e. filename.md|alias Private or Broken Links
The page you're looking for is either not available or private!


• Process to place rendered markdown into layouts is determined based on the file’s extension and consequently based on the front matter

  • It will determine whether to take the output string from the preceding stage and place into layouts or not.
  • A layout template that has a layout will have nested layout placement
    • e.g. content → Post Layout → Default Layout

flowchart
%% Nodes  
	Plugin([Setting Up Plugin])
	Sourcing([Reading Source File])
	Writing([Writing Files])  
	InterpretLiquid
	ConvertMarkdown
	PopulateLayout
%% Node links  
	subgraph Main[Jekyll Rendering Process]
		direction LR
		Plugin --> Sourcing --> RenderingPhase --> Writing
	end
	subgraph RenderingPhase[Rendering Phase]
		direction TB
		InterpretLiquid --> ConvertMarkdown --> PopulateLayout
	end

References

• [Rendering Process

  Jekyll • Simple, blog-aware, static sites (jekyllrb.com)](https://jekyllrb.com/docs/rendering-process/)

Metadata

• topic:: 00 Coding00 Coding
  #MOC / for programming language, coding guide and libraries focusing on data analytics and html/css
  
  • related:: 01 Jekyll01 Jekyll
    #MOC / for notes sub to 00 Coding with focus on how I use Jekyll
    
• created:: 2023-01-15 Private or Broken Links
  The page you're looking for is either not available or private!
  
• updated:: 2023-01-15 Private or Broken Links
  The page you're looking for is either not available or private!
  
• #PermanentNote