Design File to WordPress — Easy Setup Guide & Examples

MARKZWARE CUSTOMER GUIDE · CODEX DESKTOP FOR MAC WALKTHROUGH

Turn existing InDesign, Publisher, QuarkXPress and PDF content into editable WordPress drafts—with OmniMarkz and an AI agent. Version 4 uses a Google font when one can stand in for a design font.

No programming experience required. Your original files remain intact, and the new content stays a WordPress draft until you choose to publish it.

Beginner friendlyMac walkthroughWindows compatibleNo terminal commands

Other AI agents and Windows: The Design File to WordPress skill can also be used with Cursor and Claude. The overall setup and workflow are similar, but this step-by-step walkthrough specifically demonstrates Codex Desktop on a Mac. The workflow also works on Windows; application menus, installation paths, and connection steps may differ.
Download the Design File to WordPress Skill ↓

Watch the setup walkthrough Back to contents ↑

Watch the short walkthrough before following the step-by-step Mac setup below.

If the player doesn’t appear, watch the walkthrough on YouTube.

PART 1 · BEFORE YOU START

1. Choose the right application ↑ Back to contents

Codex Desktop for Mac is the app used in this walkthrough. Cursor and Claude can also work with the Design File to WordPress skill, following a similar process. The workflow is also available on Windows, although the exact menus, local folder paths, and agent configuration differ. To keep the instructions easy to follow, the steps and screenshots below focus on Codex Desktop on a Mac.

The similarly named browser tools do not automatically read skill folders stored on your computer.

ApplicationWhat to know
ChatGPT in ChromeGood for conversation; doesn’t automatically access local Mac skills.
ChatGPT DesktopA separate Mac application, not the same as Codex Desktop.
Codex in a browserDoesn’t automatically read the skills folder on your Mac.
Codex Desktop for MacRecommended for this guide. Works with local skills and supported connections.

Using Cursor, Claude, or Windows? Follow the corresponding skill installation and MCP connection instructions for your application and operating system rather than assuming the Mac paths below apply.

What you will need for this Mac walkthrough Back to contents ↑

  • A Mac with Codex Desktop installed
  • A working copy of OmniMarkz
  • A WordPress website where you can create posts
  • A sample INDD, PUB, QXP or PDF file
  • The Markzware Design File to WordPress skill

The setup steps below are usually done once. Everyday conversions are simpler.

PART 2 · ONE-TIME SETUP

2. Install the skill on your Mac ↑ Back to contents

Download and unzip Back to contents ↑

  1. Download the ZIP file.
  2. Open Finder → Downloads.
  3. Double-click design-file-to-wordpress.zip.
  4. Find the unzipped folder named design-file-to-wordpress.

Move the folder into place Back to contents ↑

  1. Open Finder and choose Go → Go to Folder….
  2. Paste ~/.agents/skills/ and press Return.
  3. Move the design-file-to-wordpress folder there.
  4. If the path does not exist, create .agents in your Home folder and skills inside it. In Finder you can show hidden folders by pressing Command + Shift + .
  5. Quit and reopen Codex Desktop.
What the path means: ~ is your Home folder, .agents is a hidden folder, and skills is where the skill lives. Your final file should be at ~/.agents/skills/design-file-to-wordpress/SKILL.md. Avoid an extra nested design-file-to-wordpress folder.

Check that Codex can find it Back to contents ↑

Can you find my installed Design File to WordPress skill? Please confirm the skill is available. Do not create or publish anything yet.

3. Connect OmniMarkz Back to contents ↑

Publishing file→OmniMarkz→Codex→WordPress draft

OmniMarkz reads the file. A connection called MCP lets the AI agent request its document information.

  1. Open OmniMarkz.
  2. Choose OmniMarkz → Preferences (or Settings).
  3. Open MCP and enable the server.
  4. Follow the available instructions for connecting a compatible desktop agent.
  5. Restart Codex Desktop and, if needed, OmniMarkz.
Important: An OmniMarkz option labeled “Install ChatGPT Desktop MCP” is not automatically a Codex Desktop connection. Verify the Codex connection separately.

Ask Codex:

Can you see the OmniMarkz MCP tools? Please check whether you can communicate with OmniMarkz. Do not modify any documents or publish anything.

4. Create a WordPress application password Back to contents ↑

An Application Password lets a supported agent access WordPress through its API. This is not your normal website login password.

  1. Sign in to your WordPress dashboard.
  2. Choose Users → Profile (or Users → Your Profile).
  3. Scroll to Application Passwords.
  4. Enter the name Markzware Design File to WordPress.
  5. Click Add New Application Password.
  6. Copy the generated password before leaving the page.
WordPress may display that generated password only once. If you lose it, create a new one and revoke the old one. For details see WordPress Application Passwords documentation.

5. Keep the password in a private location Back to contents ↑

For the TextEdit method described here:

  1. Open TextEdit → File → New.
  2. Choose Format → Make Plain Text.
  3. Paste only the application password.
  4. Save as wordpress-app-password.txt in a private Home-folder location, such as ~/WordPress-Credentials/.
  5. Use Finder’s Go → Go to Folder… to find it later.
Security: Plain-text files are not encrypted. Prefer a secure credentials manager for production use. Never paste the secret in a chat, put it inside the downloaded skill, or save it in a shared/cloud-synced folder. Revoke a password if exposed.

6. Connect Codex to WordPress Back to contents ↑

Tell Codex your site URL, WordPress username, and the location of the password file—not the password itself. Replace the example values:

I want to connect the Design File to WordPress skill to my WordPress site.
Website: https://example.com
WordPress username: your-username
Local application password file: ~/WordPress-Credentials/wordpress-app-password.txt
Please check whether you can securely read the local credential file and authenticate with WordPress. Do not display or repeat the password in chat or logs. Do not create, update, or publish any posts yet. Tell me if another permission or connection step is needed.

Approve only permissions you understand. Codex should verify authentication before changing any posts.

PART 3 · YOUR FIRST DRAFT

7. Turn a publishing file into a WordPress draft ↑ Back to contents

  1. Choose a small sample document (a newsletter, article or brochure) and store it somewhere easy to find.
  2. Open Codex Desktop.
  3. Paste this prompt and give Codex access to the sample when it requests it.
Use my Design File to WordPress skill and OmniMarkz to read a publishing document from my Mac.
Ask me to choose the document if you need its location.
Create an editable WordPress post using Gutenberg headings, paragraphs, and available images. Preserve the original wording as much as practical.
Save it as DRAFT ONLY. Do not publish or schedule it.
When finished, give me the WordPress draft editing link and report any text or images that could not be transferred.

Review the result Back to contents ↑

  1. Open the WordPress dashboard.
  2. Choose Posts → All Posts and find the post marked Draft.
  3. Click Edit to open Gutenberg.
  4. Check headings, paragraphs, reading order, images and links.
  5. Use Preview and then Save draft.
Draft only: The new draft is not automatically public. Print layouts may need adjustment for responsive webpages; the goal is editable content, not a pixel-perfect page reproduction.

PART 4 · EVERYDAY EXAMPLES

8. What can you create? ↑ Back to contents

Publisher newsletter Back to contents ↑

Reuse a church, school or community newsletter as online content.

InDesign magazine article Back to contents ↑

Build a structured blog article from a designed print story.

QuarkXPress document Back to contents ↑

Bring archival editorial content into a modern web post.

PDF brochure Back to contents ↑

Convert usable brochure text and pictures into editable blocks.

Publisher newsletter prompt Back to contents ↑

Use OmniMarkz to read my Microsoft Publisher newsletter. Create a WordPress draft with the newsletter title, article headings, readable paragraphs, and usable images. Keep the original information and separate distinct articles into sections. Do not publish.

InDesign magazine prompt Back to contents ↑

Read my InDesign magazine file using OmniMarkz. Identify the main article, headline, subheadings, body text, and related images. Turn it into a clean, editable WordPress blog post using Gutenberg blocks. Preserve the author's wording and flag any uncertain reading order. Save as draft only.

QuarkXPress prompt Back to contents ↑

Use OmniMarkz to read my QuarkXPress document. Organize its content into appropriate WordPress Gutenberg headings, paragraphs, and images. Preserve the original writing, check column reading order, and report any missing content. Create a draft only.

PDF brochure prompt Back to contents ↑

Read my PDF brochure through OmniMarkz. Create an editable WordPress draft using Gutenberg blocks. Preserve the product names, descriptions, headings, and relevant images. Do not invent missing information. Tell me if any material cannot be extracted. Do not publish.

Using the WordPress Media Library Back to contents ↑

Where supported, ask Codex to upload usable extracted images into WordPress rather than creating flat page screenshots.

Read my publishing document using OmniMarkz. Extract any usable images made available by the document reader. Upload appropriate images to the WordPress Media Library and reuse those items in Gutenberg image blocks. Avoid duplicates, report missing images, and keep the post as a draft.

Image extraction and placement depend on the source document and the capabilities of the current skill. Some linked images and formats may require extra attention.

PART 5 · TROUBLESHOOTING

9. Common questions ↑ Back to contents

I’m using ChatGPT in Chrome and it cannot find the skill.

For the steps in this Mac walkthrough, open Codex Desktop. A browser conversation does not automatically read your Mac’s local skill folder. Cursor and Claude are also compatible options but require their own setup.

Finder can’t find the .agents folder.

The folder is hidden. Use Go → Go to Folder and enter ~/.agents/skills/. If it doesn’t exist, create it in your Home folder. Press Command + Shift + . to show hidden files.

Codex cannot find SKILL.md.

Confirm that SKILL.md is directly inside ~/.agents/skills/design-file-to-wordpress/, not inside another nested folder. Reopen Codex.

Codex cannot see OmniMarkz.

Check OmniMarkz → Preferences → MCP and verify that the MCP server and the correct compatible agent connection are configured. A ChatGPT Desktop installation is not necessarily a Codex connection.

Application Passwords is missing in WordPress.

Check Users → Profile. Some site policies or plugins disable this feature; ask your site administrator. HTTPS may also be required.

WordPress authentication fails.

Use your WordPress username and the generated Application Password, not your usual login password. Check the saved file for extra text. If necessary, revoke it and create a new one.

Codex cannot access the saved password file.

Confirm the path exists and the agent has permission to read it. Do not copy the password into chat or put it in the skill folder.

My WordPress content isn’t editable.

Check that the post contains Gutenberg heading, paragraph, and image blocks rather than one flat image or a single giant HTML block.

Images are missing or the design looks different.

Ask Codex which images were successfully extracted and uploaded. Complex print pages often need layout adjustments in WordPress, particularly on mobile.

I can’t find the draft.

Check Posts → All Posts → Draft. Verify the correct site and ask Codex for the post ID or edit URL. Do not assume the post was created until WordPress confirms it.

Does the Design File to WordPress skill work on Windows?

Yes. The Design File to WordPress workflow also works on Windows and supports compatible AI agents, including Codex, Cursor, and Claude. The overall process is similar to macOS, although installation paths, application menus, and OmniMarkz connection settings may differ.

This walkthrough focuses on Codex Desktop for Mac. Windows users should follow the corresponding setup instructions for their applications.

Can I use Cursor or Claude instead of Codex?

Yes. The Design File to WordPress skill is designed to work with compatible AI agents, including Cursor and Claude. The general workflow is similar: install the skill, connect OmniMarkz, configure WordPress access, and create an editable draft.

The instructions and screenshots in this guide specifically demonstrate Codex Desktop for Mac.

PART 6 · FINAL REVIEW

10. Check your draft before publishing ↑ Back to contents

  • The title and headings are correct
  • All text is present and in the right reading order
  • Images are correctly placed and have appropriate alt text
  • Links, tables and formatting are reviewed
  • Desktop and mobile previews look acceptable
  • The post status is still Draft
You control publication. Review the result in Gutenberg and publish only when you are satisfied.
Get the Design File to WordPress Skill ↓

This is version 4. A Google font is used when one can stand in for a design font. The exact Codex MCP connection, Gutenberg block handling and image upload behavior should be tested on your environment before being represented as universally supported.

Markzware · Design File to WordPress · Mac setup guide

PART 5 · TROUBLESHOOTING

9. Common questions ↑ Back to contents

I’m using ChatGPT in Chrome and it cannot find the skill.

Use Codex Desktop for this setup. A browser conversation does not automatically read your Mac’s local skill folder.

Finder can’t find the .agents folder.

The folder is hidden. Use Go → Go to Folder and enter ~/.agents/skills/. If it doesn’t exist, create it in your Home folder. Press Command + Shift + . to show hidden files.

Codex cannot find SKILL.md.

Confirm that SKILL.md is directly inside ~/.agents/skills/design-file-to-wordpress/, not inside another nested folder. Reopen Codex.

Codex cannot see OmniMarkz.

Check OmniMarkz → Preferences → MCP and verify that the MCP server and the correct compatible agent connection are configured. A ChatGPT Desktop installation is not necessarily a Codex connection.

Application Passwords is missing in WordPress.

Check Users → Profile. Some site policies or plugins disable this feature; ask your site administrator. HTTPS may also be required.

WordPress authentication fails.

Use your WordPress username and the generated Application Password, not your usual login password. Check the saved file for extra text. If necessary, revoke it and create a new one.

Codex cannot access the saved password file.

Confirm the path exists and the agent has permission to read it. Do not copy the password into chat or put it in the skill folder.

My WordPress content isn’t editable.

Check that the post contains Gutenberg heading, paragraph, and image blocks rather than one flat image or a single giant HTML block.

Images are missing or the design looks different.

Ask Codex which images were successfully extracted and uploaded. Complex print pages often need layout adjustments in WordPress, particularly on mobile.

I can’t find the draft.

Check Posts → All Posts → Draft. Verify the correct site and ask Codex for the post ID or edit URL. Do not assume the post was created until WordPress confirms it.

PART 6 · FINAL REVIEW

10. Check your draft before publishing ↑ Back to contents

  • The title and headings are correct
  • All text is present and in the right reading order
  • Images are correctly placed and have appropriate alt text
  • Links, tables and formatting are reviewed
  • Desktop and mobile previews look acceptable
  • The post status is still Draft
You control publication. Review the result in Gutenberg and publish only when you are satisfied.
Get the Design File to WordPress Skill ↓

This is version 4. A Google font is used when one can stand in for a design font. The exact Codex MCP connection, Gutenberg block handling and image upload behavior should be tested on your environment before being represented as universally supported.

Markzware · Design File to WordPress · Mac setup guide
Title: Design File to WordPress — Easy Setup Guide & Examples
Published on: October 20, 2026
Patrick Marchese

Patrick Marchese is Founder and President of Markzware, a company with more than 30 years of experience developing technologies for professional publishing workflows. He has helped pioneer high-fidelity document conversion, preflight, structured layout intelligence, and AI-powered publishing automation. Today, Patrick leads the development of Professional Publishing Document Intelligence™, helping organizations assess, preserve, convert, and reuse complex publishing documents through Conversion Center, MZJSON, and the OmniMarkz MCP Server.

Related Articles

Stay Connected!

SUBSCRIBE
Close