Problems encountered when converting Word to Markdown

Aspose.Words Product Family
1

When I converted Word to markdown, the "#######" in the Word content changed to "\#######", as shown in the attachment
test 2.zip (10.7 KB)

Document doc = new Document("/Users/zhengkai/Documents/other/test.docx");
doc.save("/Users/zhengkai/Documents/other/test.md");
2

@zhengkai

When converting a Word document to Markdown using Aspose.Words, you may encounter issues with certain characters being escaped incorrectly. In your case, the "#######" in the Word content is being converted to "\#######". This behavior can occur due to the way Markdown interprets certain characters, particularly those used for formatting.

To address this issue, you can utilize the MarkdownSaveOptions class, which allows you to customize the conversion process. Here’s a basic example of how to set up the conversion:

import com.aspose.words.*;

public class WordToMarkdown {
    public static void main(String[] args) throws Exception {
        // Load the Word document
        Document doc = new Document("/path/to/your/document.docx");

        // Create MarkdownSaveOptions
        MarkdownSaveOptions saveOptions = new MarkdownSaveOptions();
        
        // You can customize saveOptions here if needed

        // Save the document as Markdown
        doc.save("/path/to/your/output/document.md", saveOptions);
    }
}

If the issue persists, consider checking the content of your Word document for any specific formatting or characters that might be causing the escape sequence. Additionally, ensure that you are using the latest version of Aspose.Words, as updates may include fixes for such issues.

For more detailed information on saving documents as Markdown and the options available, you can refer to the official documentation on this topic.

If you continue to experience problems, please provide more details about the specific content or formatting in your Word document that might be causing the issue.

Sources:
[1]: Saving Documents as Markdown in Aspose.Words for Java