=== Biznova Markdown File Importer for Block Editor ===
Contributors: biznova
Author: BizNova
Author URI: https://biznova.tech
Tags: markdown, block-editor, importer, blocks, converter
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Upload a Markdown (.md) file and convert it into a block-editor post or page built from native blocks.

== Description ==

Markdown to Block Editor Importer lets you turn a Markdown document into a WordPress post or page in a single click. Headings, paragraphs, lists, blockquotes, fenced code, horizontal rules, images, and links are mapped to native blocks so the result opens cleanly in the block editor.

This plugin does **not** add a top-level menu item. After activating, find it under:

* **Tools → Markdown Importer** — upload a `.md` file and create a post/page.
* **Settings → Markdown Importer** — set the default status (Draft or Publish automatically).

= How to use =

1. (Optional) Go to **Settings → Markdown Importer** and choose the default status: Draft or Publish automatically.
2. Go to **Tools → Markdown Importer**.
3. Choose your Markdown file and (optionally) a title and content type. The status is pre-selected from your setting but can be overridden.
4. Click **Import Markdown** — you are taken to the new post/page in the block editor.

= Heading mapping =

* The first `#` (H1) becomes the post/page **title** automatically.
* `##` becomes an H2 block; `###` becomes an H3 block.

= Markdown to block mapping =

| Markdown | Block result |
|---|---|
| `# Title` (first H1) | Post/page **title** (not a body block) |
| `## Section` | H2 heading block |
| `### Sub-section` | H3 heading block |
| Plain text | Paragraph |
| `- item` / `* item` | Unordered list |
| `1. item` | Ordered list |
| `> quote` | Blockquote |
| ` ``` code \`\`\` ` | Code block |
| `---` / `***` | Separator |
| `[text](url)` | Link |
| `![alt](image.png)` | Image |
| `**bold**`, `*italic*`, `` `code` ``, `~~strike~~` | Inline formatting |

= Troubleshooting =

* **Can't see the menu item** — it's a submenu: look under **Tools → Markdown Importer**, not the top level. Confirm the plugin is still Active (WordPress auto-deactivates crashing plugins).
* **File rejected** — only `.md`/`.markdown`, under 1 MB (filter `mdgi_max_upload_bytes`).
* **Wrong title** — a typed title wins; else the first `#` heading; else the file name.

== Installation ==

1. Upload the `biznova-markdown-file-importer` folder to `/wp-content/plugins/`.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to **Tools → Markdown Importer**.

== Frequently Asked Questions ==

= Does it require the block editor? =

Yes. Content is produced in the block-editor block format and is best edited in the block editor.

= Are my uploads stored? =

No. Files are read from the temporary upload location and converted in memory. The plugin stores no files or options of its own.

== Changelog ==

= 1.0.0 =
* Initial release.
