Pro User
  • All of Microsoft
  • My Role
    • All in My Role
    • Pro User
    • Administrator
  • Focus
    • All in Focus
    • Microsoft Ignite 2026
    • Microsoft Copilot
    • All about AI
    • M365 Admin
    • What's Hot
    • M365 Release
Timespan
explore our new search
SharePoint Knowledge Base: import Markdown files
SharePoint Online

SharePoint Knowledge Base: import Markdown files

by HubSite 365 about Laura Rogers [MVP]

Teams can import Markdown files and folders into a SharePoint Knowledge Base, preserving folder hierarchy for existing documentation.

Key insights

  • Choose New > Import in a SharePoint Knowledge Base, then select Markdown files or Folder.
  • Folder imports preserve the source folder hierarchy.
  • Markdown imports are one-time copies, not ongoing synchronization.
  • Imported pages use the destination knowledge base's permissions; source permissions and sensitivity labels do not transfer.
  • The feature is in Frontier preview and currently requires usage-based billing.

SharePoint Knowledge Base can import Markdown files and folders, bringing existing documentation into SharePoint pages instead of requiring teams to recreate it manually. This is useful for documentation owners and SharePoint users moving procedures, technical guides, or team knowledge into a central collection. Laura Rogers [MVP] is the publisher associated with this import topic.

What it does

The import feature accepts individual Markdown files or a folder of Markdown content. When you import a folder, SharePoint keeps its folder hierarchy, which can help preserve the organization of an existing documentation set. The resulting pages become part of the SharePoint Knowledge Base.

Knowledge-base content can be read by people and used in Microsoft 365 AI experiences, including Copilot in SharePoint. Importing content and asking Copilot questions about it are separate capabilities: importing does not itself require a Copilot license, while Copilot use may require the appropriate license or credits.

Who it is for and what you need

This feature is aimed at organizations with existing Markdown documentation, such as procedures, internal guidance, or technical documentation. It is in Frontier preview, so availability can vary between organizations and the interface may change.

Microsoft's current requirements include usage-based billing. You also need permission to create or edit content in the destination knowledge base and access to the source files or folder. The input must be Markdown in format; changing another file's extension to does not convert its contents.

How it works

  1. Open the SharePoint Knowledge Base that will receive the content.
  2. Select New, then Import.
  3. Choose Markdown files for individual files or Folder to import a folder and its hierarchy.
  4. Select the source files or folder and follow the import prompts.
  5. Review the resulting pages in the knowledge-base navigation.

You can also choose Import Markdown files as the initial content source when creating a knowledge base.

Limitations and alternatives

Import is a one-time copy, not a live link to the original files. Later edits in either location do not automatically update the other, so teams should decide which location is authoritative.

Images referenced by Markdown files are not copied automatically. Review imported pages and check that images and other linked resources remain accessible. Source permissions and sensitivity labels also do not transfer; imported pages use the destination knowledge base's permissions.

For large libraries, handle content in smaller batches and review results before continuing. Avoid starting another import into the same destination while one is running. Check the import report before retrying an interrupted import, since a retry can create duplicates. Other migration options include Confluence spaces and eligible SharePoint Classic wiki pages.

Sources

Frequently asked questions

How do I import Markdown files into a SharePoint Knowledge Base?

Open the knowledge base, select New > Import, choose Markdown files or Folder, select the content, and follow the prompts.

Does a SharePoint Markdown import keep the folder structure?

Yes. Importing a folder preserves its hierarchy in the knowledge base.

Does importing Markdown require a Copilot license?

The import itself does not require a Copilot license. Asking Copilot questions about knowledge-base content may require the appropriate license or credits.

Do permissions and images carry over when importing Markdown?

Source permissions and sensitivity labels do not transfer; the imported pages use the destination knowledge base's permissions. Referenced images are not copied automatically.