FAQ Conversion Guide

What Was Done

I've converted your old FAQ shortcode format to proper, SEO-friendly HTML with structured data (Schema.org markup).

Old Format (WordPress Shortcode)

[sc_fs_multi_faq headline-1="h4" question-1="..." answer-1="..." count="5" ...]

New Format (Proper HTML with Schema.org)

## Frequently Asked Questions

<div class="faq-section" itemscope itemtype="https://schema.org/FAQPage">

<div class="faq-item" itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
<h4 class="faq-question" itemprop="name">Question here?</h4>
<div class="faq-answer" itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
<div itemprop="text">
Answer here.
</div>
</div>
</div>

<!-- More FAQ items... -->

</div>

Benefits of the New Format

1. SEO Improvement: Google can now properly read and index your FAQs
2. Rich Snippets: Your FAQs may appear as rich results in Google search
3. Better Accessibility: Screen readers can properly navigate FAQ sections
4. Future-Proof: No dependency on WordPress plugins or shortcodes
5. Mobile-Friendly: Works perfectly with your new responsive design

Files Converted

✅ 2021-02-02-is-powershell-worth-learning-2021.md - Manually converted with improved answers

How to Convert Remaining Files

I've created a Node.js script that will automatically convert all remaining files.

Running the Conversion Script

1. Open a terminal in your C:\dev\itblogpros directory
2. Run the conversion script:

node convert-faqs.js

The script will:

• Scan all .md files in the posts directory
• Find any files with old [sc_fs_multi_faq] shortcodes
• Convert them to proper HTML with Schema.org markup
• Report how many files were processed

Manual Conversion (if needed)

If you prefer to convert files manually or want to improve the answers like I did:

1. Find the old shortcode in your post
2. Replace it with the new HTML structure
3. Use proper Schema.org attributes for SEO
4. Improve answers for clarity and current information (2025 context)

Styling

The FAQ sections will automatically use the existing styles from your style.css:

• .faq-section - Container for all FAQs
• .faq-item - Individual FAQ item
• .faq-question - Question heading
• .faq-answer - Answer container

These styles are already in your CSS file, so the FAQs will look great out of the box!

Testing

After conversion:

1. Build your site: npx @11ty/eleventy --serve
2. Check that FAQs display correctly on your posts
3. Validate Schema.org markup using Google's Rich Results Test: https://search.google.com/test/rich-results

Notes

• The conversion script preserves all your content
• Original files are overwritten, so make sure you have a backup if needed
• The script removes duplicate "## FAQ" headers that might precede the shortcode
• All FAQs now have proper semantic HTML and Schema.org structured data

Questions?

If you encounter any issues with the conversion or have questions, let me know!