A collection of markdown files for my blog.

Posts

• store markdown posts in separate dedicated repository (here)
• posts can be stored in directories with related assets (images, videos, etc.)
• frontmatter should contain article details

Deployment

• posts should be
• blog should statically generated
• trigger Cloudflare page builds when SvelteKit blog repository changes
• use Cloudflare deploy hooks to trigger new build when this markdown repo changes

Features

• fuzzy search
• posts should be searchable
• filter by tags
• automatic table of contents
• mobile table of contents slideover
• edit on GitHub link
• automatic (or curated) related posts
• automatic series (multiple markdown posts in same directory)
• dark mode

Development (in Blog repository)

• code blocks should be rendered in a dedicated component
  • grouped code
  • styles
    • individual
    • grouped/tabbed
    • editor/tree view
  • metadata on code fence, i.e. ```js file="index.js" comment="related note here"
  • frontmatter metadata inside code fence
  • copy button
  • syntax highlighting using Prism
  • diff highlighting
  • code block comments
  • links (e.g. code screenshot, github gist link, tailwind play url)
  • indent diffs correctly
  • fix rendering bug with grouped code bocks at the end of article
• clean up custom plugins and global components
• embeds using custom link tag
  • youtube [!youtube](https://youtube.com/<video-id>)
  • GitHub gists [!gist](https://gist.github.com/<gist-id>)
  • Twitter [!tweet](https://twitter.com/<tweet-id>)
• custom callout component using quote syntax
  • support different syntax
    • > :warning: This is a warning (custom style)
    • > **Warning** This is a warning (GitHub style)
    • ::: warning \n This is a warning \n::: (Virepress style)
  • types
    • quote
    • information
    • tip
    • danger
    • warning
    • success