Think about structure, not length
Changing a file’s extension to .md doesn’t convert it into Markdown. A converter needs to extract content and rebuild titles, paragraphs, lists, and tables. Quality depends both on the format and on how the document was produced.
A PDF may contain selectable text or only page images. In the second case, character recognition will be needed, called OCR. Before choosing the tool, open the document and try selecting a sentence. This simple check changes the workflow path.
Why learn
You avoid promising a conversion that the tool can’t do. Recognizing the input structure also allows you to choose specific checks for text, images, and tables.
✓ Do
Check headers, values, and notes.
✗ Avoid
Rename a PDF to .md.
Key concepts
Choose a converter with a test
Ready-made conversion tools can save work, but they need to be evaluated with documents similar to yours. Split out a small sample: a title, a table, a note, and an accented character. Convert and compare those elements.
A skill can guide the use of a CLI like AnyDoc or another compatible converter. Check the exact project, the help for the installed version, and the accepted formats. Don’t infer command syntax from the commercial name. Record the command used so you can repeat the test.
Why learn
A general benchmark doesn’t tell you whether your specific table will be preserved. A test with a representative sample produces a decision appropriate to your case.
A way to apply
- Identify whether there is selectable text or an image.
- Convert a sample and check the structure.
- Record output, version, and limitations.
Key concepts
Use Markdown as a readable structure
Markdown represents hierarchy with simple symbols. A main title uses a hash symbol; subtitles use two or three. Lists group items, and tables link values to columns. The goal is to make the text understandable for people and for tools.
Do not turn each visual line from the PDF into an independent paragraph. Page breaks, repeated headers, and stray numbers can clutter reading. Preserve the relationship between the title and the content, without deleting notes that change the meaning of a rule.
Why learn
Explicit structure helps locate information and reduces ambiguities. A number without its header can be misinterpreted even when it was extracted correctly.
# Fictional catalog for Oficina Aurora
Deadlines counted in business days.
| Service | Deadline | Example value |
|---|---:|---:|
| Text review | 2 days | R$ 80,00 |
| Catalog organization | 5 days | R$ 240,00 |
Note: the deadline starts after the files are received.
Key concepts
Verify numbers and tables
Compare totals, units, and headers. A table can look well organized and still shift values into the neighboring column. The currency symbol, the decimal comma, and the unit of measure are part of the data.
If the table cannot be reconstructed with confidence, record that limitation alongside the relevant excerpt. It’s better to keep an explicit open issue than to produce a false structure. For spreadsheets, also check whether the result shows calculated values, formulas, or both; that changes the meaning of the output.
Why learn
Structure errors are subtle and can contaminate later analyses. Checking a few critical cells identifies problems that do not show up when counting characters or pages.
✓ Do
Preserve the original and record the tool.
✗ Avoid
Treat extracted text as automatically correct.
Key concepts
Save the source and the version
Keep the original file in a separate folder and record the output name, the tool, the date, and any warnings. A hash is a fingerprint calculated from the bytes: it helps you notice if the file changed. It does not reveal the content and it does not replace a copy.
When the document is updated, convert it again and compare the relevant excerpts. Avoid overwriting a version used in a decision without recording the change. A small JSON or CSV manifest is already enough to track the relationships.
Why learn
Traceability makes it possible to answer where a piece of information came from. It also prevents repeatedly converting identical files or continuing to use an old version without noticing.
| Criterion | Expected evidence |
|---|---|
| Structure | Title, table, and note preserved. |
| Values | Correct units and decimal places. |
| Tracking | Input file identified in the manifest. |
Key concepts
Practice: recover a small table
Use the exercise’s fictional data to produce a document with a title, an introduction, and a table. Simulate a faulty conversion by removing the header of a column. Explain what cannot be interpreted with confidence until you restore it.
After that, add a note that changes the deadline of an item. Check that the note appears alongside the content it refers to. The delivery should include the Markdown and a short list of the elements you verified.
Why learn
Practice teaches you to validate meaning, not just appearance. This skill will be necessary when documents feed research, customer support, or automatic reports.
Your exercise
Recreate the example catalog in Markdown. Temporarily remove the “Deadline” title and assess what happens to the values “2” and “5”. Restore the header and record three checks.
Download practice sheetCheck the commented answer
Without the header and the unit, 2 and 5 could represent quantity, days, or another measurement. The correct output keeps “Deadline,” explicitly states business days, and preserves the start condition. Checks: two service lines, monetary values matching the input, and a note linked to the deadlines.
Check your understanding
A PDF displays pages as images. What feature might be needed?
Key concepts
What stays from this module
A Markdown document with source, checked tables, and conversion warnings.
- ✓ Title, table, and note preserved.
- ✓ Correct units and decimal places.
- ✓ Input file identified in the manifest.
Progress records your reading. The practice is completed when you check the submission.