What it does
设置Markdown导出为docx时的样式,可控制导出docx的段落文字、标题编号等样式,适用于obsidian、typora、思源笔记等Markdown笔记软件,支持Codex、Claude Code等调用skill丨Template for exporting Markdown to docx (Word) using pandoc
- Connects Instruction files the AI reads
- Account or key No key found in README or SKILL.md
- Category Coding
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/achuan-2-pandoc-docx-template)Use together with
MCP servers that connect the AI to services for the same work
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Similar Skills
Same kind of work, ordered like the Skills list
| This one pandoc_docx_template | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| Maker | Achuan-2 | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skills | 1 | 1 | 1 | 1 | 1 |
| GitHub stars | 1,110 | 467,235 | 234,125 | 149,873 | 144,332 |
| Last code change | Jul 9, 2026 | Nov 18, 2026 | Apr 20, 2026 | Nov 18, 2026 | Nov 18, 2026 |
| License | – | MIT | – | Apache-2.0 | MIT |
1 skills (instruction sets) by Achuan-2 that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Claude CodeCodex
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account Achuan-2 (person), 6 years old
- Use and upkeep
★ 1,110 stars · code last changed Jul 9, 2026
- Any scripts?
8 scripts that can run on a computer: lua/add-inline-code.lua, lua/image-title-to-caption-add-number.lua, lua/image-title-to-caption.lua, lua/markdown-html-recognition.lua and 4 more
- Uses the internet?
No internet calls found in the scripts
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 8f94b99 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Download from GitHub
This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the pandoc_docx_template folder again. The ZIP must have a pandoc-docx-template folder with SKILL.md at the top level, no loose files
Open Skills on claude.ai and upload
+Create skillUpload a skillpick pandoc-docx-template.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /pandoc_docx_template or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/achuan-2/pandoc_docx_template.git /tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99/.' ~/.claude/skills/pandoc_docx_templateRestart Claude Code, then type /pandoc_docx_template or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the pandoc-docx-template folder at ~/.agents/skills/pandoc-docx-template
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/achuan-2/pandoc_docx_template.git /tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99/.' ~/.agents/skills/pandoc_docx_template
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/achuan-2/pandoc_docx_template.git /tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99/.' ~/.agents/skills/pandoc_docx_templateRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick pandoc_docx_template
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/achuan-2/pandoc_docx_template.git /tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-achuan-2-pandoc-docx-template-8f94b99/.' ~/.cursor/skills/pandoc_docx_templateIn Cursor’s Agent chat, type / and pick pandoc_docx_template
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 19, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
4,068 characters · Open the full file on GitHub
---
name: pandoc-docx-template
description: "Use this skill when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading numbering variants, list indentation variants, SCI paper templates, and Lua filters for HTML tags, image captions, font color, and inline code styles."
---
# Pandoc DOCX Template
## Overview
Use this skill to convert Markdown and DOCX files with Pandoc while applying the bundled Word reference templates in `templates/` and Lua filters in this folder. Prefer the scripts in `scripts/` for repeatable conversions, and call Pandoc directly when the local shell cannot run Bash scripts.
## Workflow
1. Check that Pandoc is available:
```bash
pandoc --version
```
2. Choose the conversion direction:
- Markdown to DOCX: use `scripts/md2docx.py`.
- DOCX to Markdown: use `scripts/docx2md.py`.
3. Choose a reference DOCX template when exporting Word:
| Template | Use for |
| --- | --- |
| `templates/template_标题不编号-列表第二行顶格.docx` | Default Chinese layout, headings without numbering, wrapped list lines flush left |
| `templates/template_标题不编号-列表第二行缩进.docx` | Headings without numbering, wrapped list lines indented |
| `templates/template_标题编号-列表第二行顶格.docx` | Numbered headings, wrapped list lines flush left |
| `templates/template_标题编号-列表第二行缩进.docx` | Numbered headings, wrapped list lines indented |
| `templates/template_标题不编号-列表第二行顶格-无首行缩进.docx` | No heading numbering and no first-line paragraph indent |
| `templates/template_sci论文-标题编号.docx` | SCI-style paper layout with numbered headings |
| `templates/template_sci论文-标题不编号.docx` | SCI-style paper layout without heading numbering |
## Markdown to DOCX
Use the default template and bundled aggregate Lua filter:
```bash
python scripts/md2docx.py input.md -o output.docx
```
Choose another template:
```bash
python scripts/md2docx.py input.md -o output.docx \
--reference "templates/template_sci论文-标题编号.docx"
```
Pass additional Pandoc options after `--`:
```bash
python scripts/md2docx.py input.md -o output.docx \
--reference "templates/template_标题编号-列表第二行顶格.docx" \
-- --highlight-style tango
```
If Bash is unavailable, run the equivalent Pandoc pipeline from the skill folder:
```powershell
pandoc input.md -t html | pandoc -f html -o output.docx `
--reference-doc "templates/template_标题不编号-列表第二行顶格.docx" `
--lua-filter "markdown-to-docx.lua"
```
The Markdown-to-DOCX workflow intentionally converts Markdown to HTML first, then HTML to DOCX. This preserves more HTML-like Markdown content than a direct Markdown-to-DOCX conversion, including common tags handled by the Lua filters.
## DOCX to Markdown
Convert Word to GitHub Flavored Markdown and extract embedded media:
```bash
python scripts/docx2md.py input.docx -o output.md --media-dir assets
```
If Bash is unavailable, run Pandoc directly:
```powershell
pandoc "input.docx" -t gfm -o output.md --extract-media=./assets --wrap=none
```
## Lua Filters
Use `markdown-to-docx.lua` as the default aggregate filter for Markdown-to-DOCX exports. Load individual filters only when a narrower conversion is needed:
- `lua/markdown-html-recognition.lua`: recognize Markdown content containing HTML tags such as `<sub>`, `<sup>`, and `<img>`.
- `lua/image-title-to-caption.lua`: use image title text as the Word caption and apply the `Figure` style.
- `lua/image-title-to-caption-add-number.lua`: add numbering for image captions.
- `lua/preserve_font_color.lua`: preserve text color from HTML spans such as `<span style="color:red">`.
- `lua/add-inline-code.lua`: apply the custom `Inline Code` style to inline code, separate from code block styling.
## Validation
After conversion, verify that the expected output file exists and that Pandoc did not report filter or reference-document errors. For DOCX output intended for final delivery, inspect it in Windows Microsoft Word because these templates were tested primarily with Windows Office and may render differently in WPS or macOS Word.
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 1,110
- Maker
- Achuan-2
- License
- No license stated This repo states no license. By default the author keeps all rights: ask before you share it or use it commercially.
- Last code change
- Jul 9, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1
- Topics
- markdown, obsidian, pandoc, siyuan-note, skills, typora