You now know where content lives and how Markdown works. This post shows the practical workflow for using WebGrid modules without guesswork.

What a Module Is

A module is a feature block you embed in a page using:

![[embeds/module-key]]

Common keys used in this scaffold:

  • blog-module
  • contact-form
  • store-module
  • gallery-module

Quick Start Pattern

Use this 4-step pattern every time:

  1. Open the page where the module should appear (blog.md, contact.md, store.md, or gallery.md).
  2. Add a short intro paragraph for context.
  3. Insert the embed line.
  4. Add a short outro or call-to-action below the embed.

That gives users orientation before and after interactive content.

Blog Module Example

---
title: Blog
visibility: public
---

Latest updates and guides:

![[embeds/blog-module]]

Start with the newest post at the top.

Contact Module Example

---
title: Contact
visibility: public
actionEmail: [email protected]
---

Questions? Send a message below.

![[embeds/contact-form]]

Store Module Example

---
title: Store
visibility: public
---

Browse products below.

![[embeds/store-module]]

Troubleshooting Checklist

If a module doesn't appear as expected:

  • Confirm the embed note name matches exactly (for example ![[embeds/blog-module]]).
  • Confirm the page has visibility: public.
  • Confirm supporting content exists (blog posts, products, gallery items).
  • Keep one blank line above and below embed syntax.

What’s Next

Next we walk through publishing workflow from draft to production-ready content.


Blog Module Syntax Guide · Publishing Workflow