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
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.
| Application | What to know |
|---|---|
| ChatGPT in Chrome | Good for conversation; doesn’t automatically access local Mac skills. |
| ChatGPT Desktop | A separate Mac application, not the same as Codex Desktop. |
| Codex in a browser | Doesn’t automatically read the skills folder on your Mac. |
| Codex Desktop for Mac | Recommended 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 ↑
- Download the ZIP file.
- Open Finder → Downloads.
- Double-click
design-file-to-wordpress.zip. - Find the unzipped folder named
design-file-to-wordpress.
Move the folder into place Back to contents ↑
- Open Finder and choose Go → Go to Folder….
- Paste
~/.agents/skills/and press Return. - Move the
design-file-to-wordpressfolder there. - If the path does not exist, create
.agentsin your Home folder andskillsinside it. In Finder you can show hidden folders by pressing Command + Shift + . - Quit and reopen Codex Desktop.
~ 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 ↑
OmniMarkz reads the file. A connection called MCP lets the AI agent request its document information.
- Open OmniMarkz.
- Choose OmniMarkz → Preferences (or Settings).
- Open MCP and enable the server.
- Follow the available instructions for connecting a compatible desktop agent.
- Restart Codex Desktop and, if needed, OmniMarkz.
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.
- Sign in to your WordPress dashboard.
- Choose Users → Profile (or Users → Your Profile).
- Scroll to Application Passwords.
- Enter the name
Markzware Design File to WordPress. - Click Add New Application Password.
- Copy the generated password before leaving the page.
5. Keep the password in a private location Back to contents ↑
For the TextEdit method described here:
- Open TextEdit → File → New.
- Choose Format → Make Plain Text.
- Paste only the application password.
- Save as
wordpress-app-password.txtin a private Home-folder location, such as~/WordPress-Credentials/. - Use Finder’s Go → Go to Folder… to find it later.
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
- Choose a small sample document (a newsletter, article or brochure) and store it somewhere easy to find.
- Open Codex Desktop.
- 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 ↑
- Open the WordPress dashboard.
- Choose Posts → All Posts and find the post marked Draft.
- Click Edit to open Gutenberg.
- Check headings, paragraphs, reading order, images and links.
- Use Preview and then Save draft.
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
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.
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
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.
