Read Specific Element
read_elementRetrieve specific content blocks from Markdown files using hierarchical paths to access structured document elements without manual text searching.
Instructions
Fetches the full content of a specific block by its path.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | ||
| path | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | No | Element content | |
| element | No | The requested element |
Implementation Reference
- Top-level asynchronous handler function for the 'read_element' tool. Delegates to the EditTool instance's read method.
async def read_element(file_path: str, path: str): return await _instance.read(file_path, path) - Core logic of the read_element tool in EditTool class: loads the cached document and retrieves the specific element using its view_element method.
async def read(self, file_path: str, path: str) -> Dict[str, Any]: doc = self.get_doc(file_path) return doc.view_element(path) - Input and output schema definition for the read_element tool, registered via list_tools().
Tool( name="read_element", title="Read Specific Element", description="Fetches the full content of a specific block by its path.", inputSchema={ "type": "object", "properties": { "file_path": {"type": "string", "examples": ["./document.md"]}, "path": { "type": "string", "examples": ["Features > list 1", "Introduction"], }, }, "required": ["file_path", "path"], "additionalProperties": False, }, outputSchema={ "type": "object", "properties": { "element": { "type": "object", "description": "The requested element", }, "content": {"type": "string", "description": "Element content"}, }, }, ), - src/markdown_editor/server.py:583-589 (registration)Dispatch/registration in the server's call_tool method: calls the read_element handler when the tool name matches.
elif name == "read_element": res = await read_element(file_path, arguments["path"]) return CallToolResult( content=[TextContent(type="text", text=json.dumps(res, ensure_ascii=False, indent=2))], structuredContent=res, isError="error" in res, ) - src/markdown_editor/server.py:15-26 (helper)Import statement bringing the read_element handler into server.py for use in tool dispatch.
from .tools.edit_tools import ( get_document_structure, read_element, replace_content, insert_element, delete_element, undo_changes, search_in_document, get_element_context, move_document_element, update_document_metadata, )