Automate Word Image Insertion with Python: A Step‑by‑Step Tutorial

1. Introduction

Hello, I am PiPi. Recently a member of the Python Silver Group asked about automating office tasks with Python, specifically inserting images into a Word document. Below is the original question and the code provided.

2. Implementation Process

Teacher Yu Liang suggested an approach, illustrated in the following diagram.

Following that idea, a fan wrote a script, but the loop section contained errors.

Later, Teacher Yu Liang provided a corrected version of the code:

path = r'C:\Users\Administrator\Desktop\pandas练习\海报\图片修改尺寸后'
files = [os.path.join(path, z) for z in os.listdir(path)]
row1 = math.ceil(len(files) / 3)  # round up
print(row1)

doc = Document()
doc.add_heading('这是第一个项目')
par = doc.add_paragraph('图片如下：')
table = doc.add_table(rows=row1, cols=3)
s1 = 0
# loop through rows and columns, insert pictures
for i in range(row1):
    for j in range(3):
        image_path = files[s1]
        table.cell(i, j).paragraphs[0].add_run().add_picture(image_path, width=Inches(1))
        s1 += 1
        if s1 >= len(files):
            print(s1)
            break
doc.save('实例.docx')

The script successfully solved the fan's problem by automatically inserting all images into the Word table.

3. Summary

This article presented a Python automation solution for inserting images into a Word document, explained the thought process, showed the initial flawed attempt, and provided a working code example that leverages the python-docx library to create a table and populate it with pictures.

When asking for help in groups, it is recommended to provide a small, anonymized data sample, include the relevant code (preferably as plain text), and attach error screenshots if the script is short; otherwise, share the script as a .py file.